前言：

本次版本升级内容大体说明：

以下针对更新进说明

一：Access应用调整

1：默认关闭事务：Access一次Open只允许执行一条语句。

2：处理DateTime类型：默认需要转成Date类型才能正确提交。

3：数据库链接字符串处理虚拟目录相对路径：

Access配置文件链接可写成：

4：修正自定义视图语句查询语句bug：由于未设置表名，查询之后返回记录总数为0。

二：修正特殊字段类型处理

1：默认uniqueidentifier、ntext、ntext、Image等字段长度为16，在提交时会被截断，本次修正字段初始并对Image类型进行特殊处理。

三：缓存类调整

1：增加Add重载方法，允许传入文件依赖路径及缓存时间

2：增加SetChange、GetHasChanged方法，允许设置及获取缓存对象是否改变。

四：增加CYQ.Data.Xml名称空间，增加5个类

1：抽象基类：XmlBase-》处理加载xml，名称空间处理，DTD处理

2：具体操作类：XmlHelper-》实现对xml具体的增删改查操作，并加入强大的功能，处理MDataRow和MDataTable。

3：DTD解析类：XhtmlUrlResolver-》实现对实体dtd路径的解析

4：多国语言：MutilLanguage-》实现对xml最基本的文本取值。

5：SetType、ValueReplace-》枚举与替换常量

五：XmlHelper 重点语法演示

A：基本语法

1：实例化 XmlHelper helper=new XmlHelper(true); //为ture则表示加载html，默认处理名称空间及解析dtd

2：加载 bool result=helper.Load(Server.MapPath("demo.html"));

3：查询 XmlNode node=helper.GetByID("cyq");//从整个文档取只取id='cyq'的节点。

4：子查询 XmlNode child=Helper.GetByID("cyqchild",node);//从node节点内容中找id='cyqchild'的节点

--其它Get与GetByXX方法类似。

5：列表查询 XmlNodeList nodeList=helper.GetList("div","id","cyq",node);//从node节点内容中找div且id='cyq'的所有节点

--这是最长的重载方法，其它重载方法省略

6：节点赋值 helper.Set(node,SetType.Value,"http://cyq1162.cnblogs.com");//对node的属性value设置值，如果属性不存在则创建。

7：其它方法详见V3.0 API文档

B：与CYQ.Data.Table 共舞,创新SetFor与SetForeach语法

1：实例化与加载略过-》并改实例名helper为Document

2：LoadData(MDataRow) 与SetFor语法，如：

using(MAction action=new MAction(TableNames.Users))
{
if(action.Fill(1))
{
Document.LoadData(action.Data);
Document.SetFor("labSpaceName");//从action.Data中取SpaceName的值赋给id=labSpaceName的节点的InnerXml属性。
Document.SetFor(IDKey.labSpaceIntro,SetType.value);//从action.Data中取SpaceIntro的值赋给id=labSpaceIntro的节点的value属性。
}
}

3：LoadData(MDataTable) 与SetForeach语法，如：

示例1：最原始循环

public void FillArticlClass()//文章分类
{
MDataTable table;
int count;
using (MAction action = new MAction(TableNames.Class))
{
table = action.Select(0, 0, string.Format("{0}={1} and {2}=0", Class.UserID, DomainID,Class.TypeID), out count);
}
if (count > 0)
{
Document.LoadData(table);
Document.SetForeach(IDKey.labArticleClass, "

"" + UrlPrefix+ "/article/category/{0}\" >{1} ({2})

", Class.ID, Class.Name, Class.Count);
}
}

示例2：原始循环+对值格式化处理

public void FillNewComment()//最新评论
{
MDataTable table;
int count;
using (MAction action = new MAction(TableNames.Comment))
{
table = action.Select(1, 10, string.Format("{0}=0 and {1}={2}",Comment.TypeID,Comment.ContentUserID, DomainID), out count);
}
if (count > 0)
{
Document.LoadData(table);
Document.OnForeach += new XmlHelper.SetForeachEventHandler(Document_OnForeach);
Document.SetForeach(IDKey.labNewComment, "

"" + UrlPrefix + "/article/detail/{0}\" >{1}

", Comment.ContentID, Comment.Body);
}
}

string Document_OnForeach(string text, object[] values, int row)
{//对评论长度进行截断
string key = Convert.ToString(values[1]);
if (!string.IsNullOrEmpty(key) && key.Length > 12)
{
values[1] = key.Substring(0, 12);
}
return text;
}

示例3：节点预处理

public void FillAllUser()//填充主页所有用户
{
using (MAction action = new MAction(TableNames.Users))
{
Document.Set(IDKey.labUserName, SetType.A, "{0}[{1}]",Config.HttpHost+"/{1}");
Document.LoadData(action.Select());
Document.SetForeach(IDKey.labAllUser, SetType.InnerXml, Users.NickName, Users.UserName);
}
}

示例4：节点预处理+格式化

private void FillForeachArticle(MDataTable table)//填充循环文章列表
{
Document.Set(IDKey.labEdit,SetType.Href,UrlPrefix + "/admin/article/edit/{0}");
Document.Set(IDKey.labDelete, SetType.Href, UrlPrefix + "/admin/article/del/{0}");
Document.Set(IDKey.labTitle, SetType.A, "{1}", UrlPrefix + "/article/detail/{0}");
Document.Set(IDKey.labCreateTime, "{2}");
Document.Set(IDKey.labIsPub, "{3}");
Document.Set(IDKey.labHits, ValueReplace.Source + "({4})");
Document.Set(IDKey.labCommentCount, ValueReplace.Source + "({5})");

Document.LoadData(table);
Document.OnForeach += new XmlHelper.SetForeachEventHandler(Document_OnForeach);
Document.SetForeach(IDKey.labArticleList,SetType.InnerXml,
Content.ID, Content.Title, Content.CreateTime, Content.IsPub, Content.Hits, Content.CommentCount);

}

string Document_OnForeach(string text, object[] values, int row)
{
values[3] = Convert.ToString(values[3]) == "1" ? "已发布" : "未发布";
return text;
}

六：V3.0 API文档与CYQ.Data.DLL下载

结言：