CYQ.Data 数据层框架

前言：

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

 以下针对更新进说明

 一：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, "<li><a href=\"" + UrlPrefix+ "/article/category/{0}\" >{1}</a> ({2})</li>", 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, "<li><a href=\"" + UrlPrefix + "/article/detail/{0}\" >{1}</a></li>", 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下载

  结言：