博客园_快速Web2.0开发框架

为什么IIS7/7.5的Gzip不起作用

2012-02-10T03:39:00Z

我在IIS7配置Gzip压缩一文中介绍了IIS7对于gzip压缩的相关配置，以及默认情况下，由于IIS7将Javascript配置为动态压缩（Dynamic Compression），受CPU还有其他因素的影响，不一定会返回gzip压缩后的内容。但是前阵子发现，尽管将Javascript配置成了静态压缩，请求Javascript脚本文件的时候偶尔还是会出现没有gzip的情况。这篇文章和大家分享一下我遇到的这个问题以及解决这个问题的过程和思路，希望对大家有所帮助。

“随机”的gzip行为

问题的症状非常简单而又奇怪。有时候连续访问脚本多次，刚开始没有gzip，再次访问又有gzip。等过好一会再去访问，gzip又没有了。有的时候则是无论怎么访问都不给我返回gzip后的响应。

问题的分析

排除了CPU负载过大的因素，因为发现当深夜机器CPU负载正常的时候也一样出现这样的问题。

在系统日志中发现以下Warning条目，引起了我的注意：

Warning 2010/4/13 6:32:41 IIS-W3SVC-WP 2264 None

The directory specified for caching compressed content C:\inetpub\temp\IIS Temporary Compressed Files\XXX is invalid. Static compression is being disabled.

通过日志筛选，发现从09年7月份就一直出现这样的Warning了，而且出现频率是隔1-3天左右。

这个文件夹是IIS用于存放压缩后的静态内容缓存。按照上面日志的意思，是说这个目录出了问题，导致静态压缩功能被禁用了。但是我明明可以访问这个文件夹，而且里头确实还放着缓存的脚本。

IIS论坛上提这个问题的帖子很多，但最终得到解答的没看到。不过其中一些人的回复倒是给了我不少思路。其中有人说道可能是文件夹权限问题，我看了看那个压缩缓存目录，上面的权限的确是应用程序池的身份，没有问题。使用ProcessMonitor监测了w3wp.exe进程的活动情况，没有看到这个进程在访问文件系统时出现错误。

后来在网上看到了Kanwaljeet Singla（IIS开发团队成员）的一篇文章，介绍IIS7相比IIS6在压缩模块上的改动，文中提到了一点，从IIS7开始，为了降低开销，IIS只对那些频繁访问的静态资源启用压缩。通过IIS7新引入的两个配置选项frequentHitThreshold和frequentHitTimePeriod，我们可以设定，当某个资源在frequentHitTimePeriod时间内被连续访问了frequentHitThreshold次，那么就算是“频繁访问”了。默认的配置是10秒钟内连续对同一Url发起2次请求就算此Url对应的资源属于频繁访问的资源，IIS服务器就会对其进行压缩，然后丢入缓存目录。

这也就解释了为什么有时候第一次请求脚本的时候，服务器没有返回gzip压缩后的内容，而是等你接着下一次访问的时候才会返回gzip响应。

但是按照这篇文章提到的IIS的设计理念，一旦资源被压缩缓存过，那么以后就不会再应用这个“频繁访问”的检测逻辑了，因为毕竟已经没有压缩开销了。而我非常确信这个脚本已经被缓存在服务器硬盘上了，那为什么我过一段时间再去访问的时候还是没有gzip呢？

在IIS7中有一个功能，叫做失败请求跟踪（Failed request tracing），允许技术人员跟踪那些出问题的请求在IIS内部都发生了什么事。为了揭开我的疑问，我对此网站开启了失败请求跟踪。

IIS7的Bug？！

打开IIS7管理器，定位到相应的网站右侧的操作面板，开启“失败请求跟踪”。默认跟踪日志文件是存放在%SystemDrive%\inetpub\logs\FailedReqLogFiles目录中。

然后在功能面板中找到“失败请求跟踪规则”进行配置：

为了防止其他脚本的干扰，在这里我限定了只跟踪测试的脚本

响应状态填写200即可

接下来是选择跟踪提供程序，也就是给你提供跟踪日志源的程序，由于我们的脚本只经过静态文件处理器，因此这里我们只需要选择www server处理程序即可。

然后我们就可以去测试一下访问出问题的脚本了。一旦IIS中途处理遇到些问题，那么就会以xml形式记录下相关的日志。打开FailedReqLogFiles目录，里头会有一些fr000001.xml这样格式的文件，每个文件代表一次失败请求。我们打开这个文件，查找compression关键词，发现了以下内容：

<Event xmlns="http://schemas.microsoft.com/win/2004/08/events/event">

<System>

<Provider Name="WWW Server" Guid="{3A2A4E84-4C21-4981-AE10-3FDA0D9B0F83}"/>

<EventID>0</EventID>

<Version>1</Version>

<Level>4</Level>

<Opcode>3</Opcode>

<Keywords>0x40</Keywords>

<TimeCreated SystemTime="2010-05-13T16:59:08.086Z"/>

<Correlation ActivityID="{00000000-0000-0000-FD2B-008041000061}"/>

<Execution ProcessID="10752" ThreadID="14504"/>

<Computer>DMZ</Computer>

</System>

<EventData>

<Data Name="ContextId">{00000000-0000-0000-FD2B-008041000061}</Data>

<Data Name="Reason">14</Data>

</EventData>

<RenderingInfo Culture="zh-CN">

<Opcode>STATIC_COMPRESSION_NOT_SUCCESS</Opcode>

<Keywords>

<Keyword>Compression</Keyword>

</Keywords>

<freb:Description Data="Reason">NOT_FREQUENTLY_HIT</freb:Description>

</RenderingInfo>

<ExtendedTracingInfo xmlns="http://schemas.microsoft.com/win/2004/08/events/trace">

<EventGuid>{E60CEE96-4472-448D-A13C-2170B18220EC}</EventGuid>

</ExtendedTracingInfo>

</Event>

在上面，我们看到了NOT_FREQUENTLY_HIT的字样，看上去响应没有gzip的原因，还是因为没有达到“频繁访问”的要求，即使请求的资源已经被压缩过然后存放在硬盘上了。似乎这个压缩缓存是有一定的时效的，就是过了多长时间就得重新验证一下这个“频繁访问”的逻辑了。

我又进行了大量的测试，发现这个失效时间大约是在5分钟。也就是说，当你频繁访问一个资源，IIS开始对其进行压缩并存放在本地压缩缓存目录之后，大约过5分钟，你再去访问，还是会重新执行“频繁访问”这个验证逻辑。

为了证实我得到的结论，我在推特上向Kanwaljeet Singla（他的推特是@kjsingla）询问了这个问题。出乎我的意料，他很快就回复了我，估计是因为我在做这个测试的时候已经半夜了，他那边刚好是白天的缘故吧。他经过测试，证实“频繁访问”的逻辑检测发生在“响应是否已经压缩”逻辑之前，这确实是IIS7/7.5的一个Bug。

解决办法倒是很简单，只需要将“频繁访问”定义得更宽泛一些即可。例如1分钟内1次访问。

<configuration>

<system.webServer>

<serverRuntime frequentHitThreshold="1" frequentHitTimePeriod="00:01:00" />

</system.webServer>

</configuration>

问题真的解决了吗？

当我以为问题圆满解决，满意的睡着之后，第二天测试的时候发现请求脚本又没有gzip了，而且这次是连着访问好几次都没有压缩，这没法用我昨晚得到的结论去解释。让我非常郁闷-_-|||

冷静！

在系统日志中，我又看到了压缩目录无效的警告信息了，但这次，这个压缩目录是真没了。回想起那个时刻做的操作，当时运营的网站抛出未处理的异常，我修改完这个异常就把应用程序池给重启了。难道是说，当网站出现异常的时候，如果强制回收应用程序池的话，会导致静态压缩目录被删除？更奇怪的是，当我再次回收应用程序池，发现这个压缩目录又被重新创建了。

为了验证我的猜想，我又重复了这个过程，让网站抛出异常=>重启应用程序池=>再次请求脚本，问题重现；我又新建了一个一摸一样配置的测试网站，同样的测试流程，却发现压缩目录正常，没有出现上述的症状。

经过细致的对比，我发现运营的网站和我测试的网站环境还是不大一样的。运营的网站时时刻刻都有外部的请求，而且还很频繁。而测试网站不会有任何干扰的流量。

为了模拟真实的情况，我用iMacro写了一个宏，不间断的向测试网站请求该脚本。一开始，可以看到压缩目录确实是存在的，然后我在中途手动回收了应用程序池。发现压缩缓存目录确实被删除了。

经过再细致的测试，我最终得到一个结论：

在IIS7/7.5中，如果为应用程序池配置了administrator的账号权限，那么如果在应用程序池处理静态文件压缩的时候回收应用程序池，会导致压缩缓存目录被删除。直到下次应用程序池健康重启的时候，此压缩缓存目录才会被重新创建。

这个结论我还没有得到IIS团队的证实。但在我几台机器上的IIS7和7.5测试的结果确实都是这样的。联想之前的系统日志中，每隔1-3天就出现这样的问题，刚好是因为IIS7默认的回收间隔是1740分钟，也就是1天5小时。我计算了一下系统日志中的所有关于静态压缩目录警告出现的时间，和这个回收间隔的倍数非常吻合。

解决办法有两个：

如果没有必要，则不要给应用程序池配置administrator的账号，使用内置的账号不会出现这样的问题。
禁用固定时间间隔回收，改成在一个相对空闲的固定时刻回收，例如半夜4点。

本文链接

如何解决ajax跨域的问题? ajax跨域调用的解决办法有很多种!

2011-07-14T06:59:00Z

　　　　解决ajax跨域的问题 ajax跨域调用的解决办法有很多种，我这里只说两种：假设s.cnblogs.com是一个评论系统，只提供javascript方式的调用。news.cnblogs.com是一个新闻系统，这个系统将评论功能委托给s.cnblogs.com。这时news.cnblogs.com发表评论的代码可能是： function sendData(data,callback) { var xmlHttp=createXmlHttpRequest(); xmlHttp.open('post','http://s.cnblogs.com/postHandler.ashx'); xmlHttp.onreadystatechange=callback; xmlHttp.send(data);//data包含要发送的数据。 } 这代代码在IE6中会有一个安全提醒，但在IE7里面，直接会出错。因为跨域。

第一种解决方案：

document.domain. 1.将sendData代码存进一个services.htm文件中。并在services.htm中设置document.domain='cnblogs.com' 2.将services.htm放到s.cnblogs.com网站根目录下面。 3.在news.cnblogs.com提交评论的页面加上<iframe id='ajaxFrame' src='http://s.cnblogs.com/services.htm' width='0' height='0'></iframe> 4.在news.cnblogs.com提交评论的页面加上 function sendData(data,callback) { ajaxFrame.window.sendData(data,callback); } 和document.domain='cnblogs.com'; 方案的缺点：只能解决跨子域的问题。

方案2：动态script 法。 1.在news.cnblogs.com提交评论的页面加上，<script id='ajaxProxy' src=''></script> function sendData(data,callback) { var proxy=document.getElementById('ajaxProxy'); proxy.src='http://s.cnblogs.com/postHandler.ashx?data="+data; proxy.onreadystatechange=callback; } 我个人更喜欢方案2，但方案的一个问题是callback可以做的事情太少，无法接收postHandler.ashx发回的所馈数据。不过，我觉得有一种变通的方案，那就是直接在postHandler.ashx中输出js,比如alert('ok');，但我测试了几次都没能成功能。感觉可能是我的RP问题。这都不是完美的解决方案，用本地代理才是终极方案！ Ajax跨域访问的问题出于安全性考虑，浏览器禁止ajax跨域访问，但当有遇到这一类需求时就直接否则ajax直接访问这一方法。当然方法一定是有的，在网上一搜能找到一堆解决方案，如动态创建iframe获取结果在传回处理的，或者用script的src属性绕过的，还有通过本地代理的，我感觉本地代理方式是一种比较完美的方法，直接通过ajax像本地服务请求，本地服务再向远程服务获取结果，然后传回客户端，当然多了中间一层代理，但过程还是ajax方式的，同时本地的 service可以任意处理出想要的结果。上回说到使用jQuery跨域调用JSON数据，但是如果对方不提供JSON数据，则需要用另外的方法实现跨域调用。这两天遇到这个问题，查了些资料，有一种基于代理的方式实现跨域调用。基本解决思路是，在本域写一个程序向对方发起请求，并且将响应内容再输出。这个程序相当于一个代理，则跨域调用就可以变成对本域的调用了。我用php实现的代理程序如下： 1 2 $remoteURL=urlencode($url); echo get_file_contents($remoteURL); 要注意的是，使用urlencode需要在php.ini中开启allow_url_fopen。

摘自：http://club.sm160.com/showtopic-99554.aspx

本文链接

MySoft.Data v2.7.3 stable 版本发布，新增部分功能，并修复其中的已知的bug

2010-04-25T06:49:00Z

此版本在简化了某些常用的操作，数据返回不再采用接口，增强了SourceList, SourceTable的功能

在这里要感谢网友提供好的建议，并帮助我修复了不少bug，在功能上也有许多的改进

昵称：Berin-230760 QQ：100538511

昵称：Ｍelody QQ：377526853

昵称：uxspy QQ：13970711

昵称：王皓 QQ：24097543

昵称：峰言峰语 QQ：95340299

还有一位园子里的朋友对我的帮助非常大，暂不知道他的QQ是多少

永远的阿哲 URL：http://www.cnblogs.com/ljzforever/

在这里忠心的感谢大家的支持，我会一如既往的为大家服务！

版本号：2.7.3 (2.7.3第一次修正)

1.修正bool字段在new出来的对象时不能更新的bug
    对new出来的对象更新进行特殊处理。
    new出来的对象更新时会更新所有提交的值
    如果从数据库中读出的实体，则只更新被修改过的值
2.将Original对象名更改为Old，修正Old赋值不正确的bug
    只有当前对象从数据库中读取并且更改时才会对Old对象赋值

3.在Entity对象上增加一个ToRowReader方法，可以按字段名来读取数据

4.修正了SourceList.ToTable()中的一个bug.
当List数据项中属性为类或结构时,调用ToTable()会出错！
5.增加了SourceTable释放托管资源的接口Dispose();

版本号：2.7.3 (2.7.3第二次修正)

1.修正数据查询时条件中出现{}这样的符号时出错的bug.
由于{}在组件内部有特殊用途，没能对传入的字符串进行特殊处理导致。

2.对TableRelation增加Select,Where,OrderBy等处理
   TableRelation<A> tr = Table.From<A>().LeftJoin<B>(A._.ID == B._.ID)
                                               .LeftJoin<C>(B._.PID == C._.PID)
                                               .Where(A._.ID == 1)
                                               .OrderBy(A._ID.Desc)
                                               .Select(A._.All,B._.Name,C._PName)
   DbSession.Default.From(tr).ToList();
3.返回的数据不再返回为接口，这样可以直接使用原始对象，省去转换的麻烦，如：
ToList()返回的为SourceList，SourceList继承于List
ToTable()返回的为SourceTable，SourceTable继承于DataTable
ToReader()返回的为SourceReader，SourceReader通过属性DataSource来访问IDataReader

4.支持内联查询语法，如下：
select [Products].*,[CategoryName] = ( select [Categories].[CategoryName] from [Categories]
where [Categories].[CategoryID] = [Products].[CategoryID] ) from [Products]
TableRelation<Products> relation = Table.From<Products>()
.Select(Products._.All, new SysField<Categories>("CategoryName", Table.From<Categories>()
.Select(Categories._.CategoryName).Where(Categories._.CategoryID == Products._.CategoryID)));

IList<Products> list = DataAccess.DefaultSession.From(relation).ToList();

版本号：2.7.3 (2.7.3第三次修正) stable

1.修正了在操作时字符串中带有 {} 时运行出错的bug.

2.修正了DbSession.Default.Update(Field,Field + 1,Where)方式运行时的错误

3.对SourceList与SourceTable在功能上进一步增强

4.存储过程与SQL语法操作中增加了字典参数传递的方法，如下
IDictionary<string, object> parameters = new Dictionary<string, object>();
parameters["$UserID"] = 1;
DbSession.Default.FromSql("select *from User where UserID = $UserID", parameters);
存储过程与之雷同
5.增加了SysValue的处理，例如
将用户ID为1的更新时间修改为当前数据库时间
DbSession.Default.Update(User._.UpdateTime,new SysValue("getdate()") User._.UserID == 1);
6.将原MySoft.Web中的MVP添加到MySoft.Data组件之中，避免在非Web项目中引用MySoft.Web程序集

这次为了MySoft.Data的代码再次被更改后发布，暂时不提供源码下载，愿请谅解！

有什么问题直接与我联系，我会及时修正。

MySoft 2.7.3 工具集与dll库下载

SimpleGuestbook(基于MVP实现).rar下载

MySoft.Data从入门到精通系列篇

点击进入MySoft问题反馈

QQ:121849018

MSN:maoyong181@hotmail.com

Gmail:mysoft181@gmail.com

QQ讨论群(MySoft)：群一：27071789 群二:107193048

本文链接

MySoft组件之MySoft.Web一个简单示例

2010-04-13T14:15:00Z

今天抽了点时间写了一个很简单的MySoft.Web相关组件的示例程序。

别看它简单，但五脏俱全，下面就一一介绍这个示例的各种实现：

第一步：建一个Web项目，引用MySoft.Web程序集：

将MySoft.Web引用添加到当前项目中，在bin目录下为最新版本，之前的版本不保证可以编译通过

第二步：配置web.config

<pages enableViewState="false" enableSessionState="true">
      <controls>
        <add tagPrefix="my" namespace="MySoft.Web.UI.Controls" assembly="MySoft.Web" />
      </controls>
    </pages>
    <httpHandlers>
      <add verb="GET,POST" path="ajax/*.ashx" type="MySoft.Web.AjaxPageHandler, MySoft.Web"/>
    </httpHandlers>

上面的controls是使用MySoft内部控件时所需的。

httpHandlers里的配置是用于Ajax处理

第三步：编写客户端脚本与服务端通讯

后台: 实现客户端读取服务端时间的代码

注意：需要启用EnableAjaxCallback

public partial class _Default : AjaxPage
{
protected void Page_Load(object sender, EventArgs e)
{

}

    [AjaxMethod]
    public DateTime GetServerDateTime()
    {
        return DateTime.Now;
    }

    protected override bool EnableAjaxCallback
    {
        get
        {
            return true;
        }
    }
}

前台：<input type="button" value="获取服务端时间" onclick="getDateTime();" />

function getDateTime() {
var time = AjaxMethods.GetServerDateTime();
alert(time.toLocaleString());
}

此处的AjaxMethods内部对象，表示当前页面所有[AjaxMethod]方法的集合

Ajax方式加载用户控件的方法：

新建一个用户控件，起名为：TestParamControl.ascx

客户端代码：

function loadUserControlWithParam() {

    var value = $('txtName').value;
    if (!value) {
        Dialog.alert('请输入名字！');
        return;
    }

//divContainer为<div id=’divContainer’ />容器

//~/TestParamControl.ascx为用户控件路径

//{Name : value }此处为用户控件的参数，可以传入多个参数

Ajax.UpdatePanel('divContainer', '~/TestParamControl.ascx', { Name: value });
}

服务端代码：

public partial class TestParamControl : System.Web.UI.UserControl, MySoft.Web.UI.IAjaxProcessEventHandler
{
protected void Page_Load(object sender, EventArgs e)
{

}

#region IAjaxProcessEventHandler 成员

    //加载数据必须实现接口IAjaxProcessEventHandler
    public void OnAjaxProcess(CallbackParams callbackParams)
    {

因为数据从客户端传入服务端为字符串，所以需要进行一些转换

callbackParams可以很方便的转换成各种数据类型，如下：

int age = callbackParams[“age”].To<int>();

DateTime time = callbackParams[“startDate”].To<DateTime>();

直接获取string，可使用callbackParams[“参数名"]或callbackParams[“参数名"].Value;

this.Label1.Text = "你的名字是：" + callbackParams["Name"].Value;
}

#endregion
}

插入代码块的功能居然报出了bug:

System.NullReferenceException: 未将对象引用设置到对象的实例。
   在 CodemarksFramework.LiveWriter.Plugins.FrmLiveWriterPlug..ctor()
   在 CodemarksFramework.LiveWriter.Plugins.FrmLiveWriterPlug..ctor(String& content)
   在 CodemarksFramework.LiveWriter.Plugins.LiveWriterAdapter.CreateContent(IWin32Window dialogOwner, String& content)
   在 WindowsLive.Writer.PostEditor.ContentSources.ContentSourceManager.PerformInsertion(IContentSourceSite sourceSite, ContentSourceInfo contentSource)

不知道有谁知道怎样解决！

先写到这里吧，自己下载源码去研究，还有很多功能需要你们自己去发掘！

这里是效果图：

Ajax加载用户控件效果图：

Dialog弹出框效果图：

Dialog提示框效果图:

示例下载地址：http://files.cnblogs.com/maoyong/WebExample.rar

MySoft.Data从入门到精通系列篇

本文链接

MySoft.Data从入门到精通系列(五)【数据更新】

2010-04-13T03:01:00Z

前一章讲了如何利用MySoft.Data进行数据的插入，利用DbSession可以实现各种数据增、删、改、查等各种复杂的处理，本章着重讲解一下数据的更新：

数据更新在日常开发中占据中非常重要的地位，尽次于查询。下面就讲解一下如何利用DbSession来进行数据的更新。

继续引用前面的DbSession配置，如下：

代码
    /// <summary>
    /// 数据库访问类
    /// </summary>
    public static class DataAccess
    {
        /// <summary>
        /// 通过配置节来实例化DbSession
        /// </summary>
        public static readonly DbSession DefaultSession = new DbSession("DataExample");

        /// <summary>
        /// 通过自定义类来实例化DbSession
        /// </summary>
        public static readonly DataExample ExampleSession = new DataExample();

    }

    /// <summary>
    /// DataExample会话类
    /// </summary>
    public class DataExample : DbSession
    {
        public DataExample()
            : base("DataExample")
        {
#if DEBUG
            this.RegisterSqlLogger(log =>
                {
                    System.IO.File.WriteAllText("c:\\log.txt", log);
                });
#endif
        }
    }

下面还是利用DataAccess.ExampleSession来进行操作：

一、强类型的数据更新

下面的操作以Products实体为例进行操作：

1、单个实体数据更新

代码            //实例化一个Products对象
            Products product = new Products()
            {
                ProductID = 1,
                ProductName = "测试产品1"
            };

            //更新单个对象
            product.Attach();
            DataAccess.ExampleSession.Save(product);

2、批量实体数据更新

代码            //实例化一组Products对象
            List<Products> list = new List<Products>();
            for (int index = 0; index < 10; index++)
            {
                list.Add(new Products()
                {
                    ProductID = index,
                    ProductName = "测试产品" + index
                });
            }

            //批量更新数据
            DbBatch batch = DataAccess.ExampleSession.BeginBatch(10);
            list.ForEach(item =>
            {
                item.Attach();
                batch.Save(item);
            });

            batch.Process();

3、带事务单个实体更新(MySoft.Data内置实现DbTrans)

代码            //实例化一个Products对象
            Products product = new Products()
            {
                ProductID = 1,
                ProductName = "测试产品1"
            };

            //使用事务进行数据插入
            using (DbTrans trans = DataAccess.ExampleSession.BeginTrans())
            {
                try
                {
                    product.Attach();
                    trans.Save(product);
                    trans.Commit();
                }
                catch
                {
                    trans.Rollback();
                }
            }

4、带事务批量实体更新(MySoft.Data内置实现DbTrans)

代码//实例化一组Products对象
            List<Products> list = new List<Products>();
            for (int index = 0; index < 10; index++)
            {
                list.Add(new Products()
                {
                    ProductID = index,
                    ProductName = "测试产品" + index
                });
            }

            //使用事务进行批量数据插入
            using (DbTrans trans = DataAccess.ExampleSession.BeginTrans())
            {
                try
                {
                    DbBatch batch = trans.BeginBatch(10);
                    list.ForEach(item =>
                    {
                        item.Attach();
                        batch.Save(item);
                    });
                    batch.Process();

                    trans.Commit();
                }
                catch
                {
                    trans.Rollback();
                }
            }

5、创建外部数据库链接方式更新

代码
            //实例化一个Products对象
            Products product = new Products()
            {
                ProductID = 1,
                ProductName = "测试产品1"
            };

            using (System.Data.Common.DbConnection conn = DataAccess.ExampleSession.CreateConnection())
            {
                //更新单个对象
                product.Attach();
                DataAccess.ExampleSession.SetConnection(conn).Save(product);
            }

注：批量插入可以采用同样的方法处理！

6、创建外部数据库事务方式更新

代码//实例化一个Products对象
            Products product = new Products()
            {
                ProductID = 1,
                ProductName = "测试产品1"
            };

            using (System.Data.Common.DbTransaction trans = DataAccess.ExampleSession.BeginTransaction())
            {
                try
                {
                    //更新单个对象
                    product.Attach();
                    DataAccess.ExampleSession.SetTransaction(trans).Save(product);
                    trans.Commit();

                }
                catch
                {
                    trans.Rollback();
                }
            }

注：批量更新可以采用同样的方法处理！

当实体存在时更新，否则插入的处理方式：

代码            Products product = new Products()
            {
                ProductID = 1,
                ProductName = "测试产品"
            };

            DataAccess.ExampleSession.InsertOrUpdate(product);

以上操作相应的都可以使用事务来处理

二、UpdateCreator数据更新

通过更新创建器同样也可以达到上面的效果，也可以进行泛型方式进行数据插入，一般情况下创建器用于没有建立对象实体时直接对表和字段的操作。

1、通过实体更新实体

代码            UpdateCreator uc = UpdateCreator.NewCreator()
            .From<Products>()
            .SetEntity<Products>(product, true);

            DataAccess.ExampleSession.Excute(uc);

2、通过字符串表与字段更新数据

代码            UpdateCreator uc = UpdateCreator.NewCreator()
            .From("Products")
            .AddUpdate("ProductName", "测试产品")
            .AddWhere("ProductID", 1);

            DataAccess.ExampleSession.Excute(uc);

三、用户自定义更新方式

DataAccess.ExampleSession.Update<Products>(Products._.ProductName, "测试产品", Products._.ProductID == 1);

条件可以多个组件产生，如下：

WhereClip where = Where.All;

if(条件一) where = where && Products._.ProductID == 1;

if(条件二) where = where && Products._.ProductID == 2;

//ProductID为1和2(相当于In操作)

if(条件三) where = where || Products._.ProductID.In(1,2);

//ProductID不为1和2(相当于Not In操作)

if(条件四) where = where || !Products._.ProductID.In(1,2);

……

DataAccess.ExampleSession.Update<Products>(Products._.ProductName, "测试产品", where);

以上通过创建器的方式同样可以用事务来操作 trans.Excute(uc);

这里只是简单的介绍了一下，还有更多的功能需要用户使用时才能体会到。

数据的更新操作就讲解到这里，下一章将讲解数据的删除(Delete)操作

有什么问题可以到此处：MySoft组件问题反馈与疑难解答

本文链接

MySoft.Data从入门到精通系列篇

2010-04-13T02:30:00Z

MySoft.Data发布至今已经有一个半月了，文档方面还是一直很欠缺，下面还是简单将相关文章做下汇总吧，以下没有链接的文档会逐步完成，这里只是简单的列一下大纲。

MySoft.Data的目的是为了用户可以快速实现数据的CURD操作，并减轻用户频繁编写数据库操作的工作量，目前支持MSAccess,Sql Server (2000/2005),Oracle,Sqlite,MySql,Firebird等数据库。

--------------------------------------------------------------------------------------

支持多表联合查询组件MySoft.Data正式发布(下载)

MySoft组件之MySoft.Data API

MySoft.Data从入门到精通系列(一)【生成实体】

MySoft.Data从入门到精通系列(二)【生成实体续(插件的使用)】

MySoft.Data从入门到精通系列(三)【DbSession的配置】

MySoft.Data从入门到精通系列(四)【数据插入】

MySoft.Data从入门到精通系列(五)【数据更新】

MySoft.Data从入门到精通系列(六)【数据删除】

--------------------------------------------------------------------------------------

MySoft.Data数据查询

MySoft.Data从入门到精通系列(七)【单表查询】

MySoft.Data从入门到精通系列(八)【多表联合查询】

MySoft.Data从入门到精通系列(九)【基于表关系查询】

MySoft.Data从入门到精通系列(十)【子查询（In、NotIn操作）】

MySoft.Data从入门到精通系列(十一)【Union查询】

MySoft.Data从入门到精通系列(十二)【分页查询】

MySoft.Data从入门到精通系列(十三)【分组与聚合操作】

MySoft.Data从入门到精通系列(十四)【字段内联查询】

MySoft.Data从入门到精通系列(十五)【多条件与排序】

--------------------------------------------------------------------------------------

MySoft.Data数据处理sql与proc处理

MySoft.Data从入门到精通系列之sql篇

MySoft.Data从入门到精通系列之proc(存储过程)篇

--------------------------------------------------------------------------------------

MySoft组件问题反馈与疑难解答

QQ:121849018

MSN:maoyong181@hotmail.com

Gmail:mysoft181@gmail.com

QQ讨论群(MySoft)：群一：27071789 群二:107193048

本文链接

MySoft.Data新版v2.7.3 beta发布，修正较多bug，新增功能尚未完全测试

2010-03-25T16:27:00Z

1.新增SetProvider()方法，可以很方便对DbSession设置任意驱动

2.修正Access中使用Sum()或Avg()等聚合操作时的bug

3.修正通过AddParameters添加的参数无法输出值的bug

4.修正了Oracle中有排序时ToSingle方法读取的数据不正确的bug

5.修正了实体中没有主键时进行关联查询出错的bug

6.强化了ISourceTable的处理，增加了自定义选择列、排序，筛选，多条关联赋值等一系列处理。

7.对DataUtils.ConvertType进行加强处理，修正了内部一个转换出错的bug

8.修正了一个ISourceTable转Entity时，Entity的属性在Table中对应的列不存在时转换报错的bug

9.增加IEntityBase接口，要以通过此接口获取更改前的原始对象及当前实体状态
注：当前实体没有进行修改时，原始对象为null
User user = DbSession.From<User>().ToSingle();
假如此时user.Name为"张三";
user.As<IEntityBase>().Original 此时为null;
当操作user.Name = "李四";
user.As<IEntityBase>().Original不再为null;
user.As<IEntityBase>().Original.As<User>().Name为"张三";
10.增加TableRelation对象，用来保存一组关系，用于多表关联时直接操作使用！
   TableRelation<A> tr = new TableRelation<A>().LeftJoin<B>(A._.ID == B._.ID)
                                               .LeftJoin<C>(B._.PID == C._.PID);
   DbSession.Default.From(tr).Select(A._.All,B._.Name,C._PName).ToTable();

下一版本目标功能：新增实体验证处理。

MySoft组件之MySoft.Data v2.7.3 源码下载

MySoft工具集与dll库

点击进入MySoft问题反馈

QQ群:27071789【mysoft官方群】

9974676【xpress开源博客群-基于mysoft开发】

本文链接

MySoft.Data从入门到精通系列(四)【数据插入】

2010-03-12T09:32:00Z

前一章讲解了如何配置DbSession，本章重点讲解利用MySoft.Data进行数据的插入操作

这里先引用一下上一章的DbSession的配置代码

DbSession配置    /// <summary>
    /// 数据库访问类
    /// </summary>
    public static class DataAccess
    {
        /// <summary>
        /// 通过配置节来实例化DbSession
        /// </summary>
        public static readonly DbSession DefaultSession = new DbSession("DataExample");

        /// <summary>
        /// 通过自定义类来实例化DbSession
        /// </summary>
        public static readonly DataExample ExampleSession = new DataExample();

    }

    /// <summary>
    /// DataExample会话类
    /// </summary>
    public class DataExample : DbSession
    {
        public DataExample()
            : base("DataExample")
        {
#if DEBUG
            this.RegisterSqlLogger(log =>
                {
                    System.IO.File.WriteAllText("c:\\log.txt", log);
                });
#endif
        }

        /// <summary>
        /// 插入实体
        /// </summary>
        /// <typeparam name="T"></typeparam>
        /// <param name="item"></param>
        /// <returns></returns>
        public int Insert<T>(T item) where T : Entity
        {
            item.Detach();
            return base.Save(item);
        }

        /// <summary>
        /// 更新实体
        /// </summary>
        /// <typeparam name="T"></typeparam>
        /// <param name="item"></param>
        /// <returns></returns>
        public int Update<T>(T item) where T : Entity
        {
            item.Attach();
            return base.Save(item);
        }
    }

针对上一节DbSession的配置，可以看到，这里对DataExample类扩展了两个方法，而在我的组件内部并没有Insert<T>(T item)与Update<T>(T item)方法，而是将其合并到了一个方法Save<T>(T item)，外部通过item.Attach()与item.Detach()来改变实体的状态。

注：item.Attach()与item.Detach()方法还有更多强大的用法，下面会重点讲到！

也许有人会觉得合并在一起很难区分插入与修改，应该直接用方法名来区分比较好，当然OK，直接在这里加上两个方法即可，还可以扩展出更多的方法来适应你项目开发的需求，比如你完全可以扩展出一个保存多个对象的方法，如下：

一次插入多条数据的扩展        /// <summary>
        /// 一次插入多条数据
        /// </summary>
        /// <typeparam name="T"></typeparam>
        /// <param name="items"></param>
        /// <returns></returns>
        public int Insert<T>(IList<T> items) where T : Entity
        {
            int ret = 0;
            foreach (T item in items)
            {
                ret += Insert(item);
            }
            return ret;
        }

用方法名来区分固然也是好的，但如果需要保存一个实体列表，而这个列表中的实体有些是需要插入的，有些是需要更新的，你该如何处理，只有一种办法，把列表拆分为两个，分别来进行插入与更新。

而使用一个方法Save<T>(T item)可以很方便解决这个问题，在外部将需要插入的方法调用item.Detach(),需要更新的实体调用item.Attach()即可，然后一次传入内部进行操作，还可以为每个实体设置插入的字段或更新的字段！这样是否使用上更优雅一些呢，如下：

Detach()方法的简单应用            Products product = new Products()
            {
                ProductName = "测试产品1"
            };
            DataAccess.ExampleSession.Save(product);
            product.Detach(Products._.UnitPrice);
            DataAccess.ExampleSession.Save(product);

如果数据库中的某些字段有默认值，比如日期字段需要保存为getdate()，就可以通过Detach()方法将其字段移除而不进行插入！

好了，DbSession的方法扩展和简单应用就讲到这里，下面开始讲解如何使用DbSession来插入数据，领略MySoft.Data带给你强大的功能体验与快速开发的便捷吧！

以下操作都以数据库Northwind为例。

一、强类型数据插入

准备工作：

新建一个MySoftExample.DataEntity的项目，使用工具将Northwind中的所有表生成实体，生成的结果如图，生成时将命名空间也设置为MySoftExample.DataEntity。

生成以上实体项目后，再新建一个MySoftExample.Web项目，将MySoftExample.DataEntity项目添加到当前项目的引用中，下面就可以通过生成的实体进行数据的操作了。

下面的操作以Products实体为例进行操作：

1、单个实体数据插入

插入单个对象            //实例化一个Products对象
            Products product = new Products()
            {
                ProductName = "测试产品1"
            };

            //插入单个对象
            DataAccess.ExampleSession.Save(product);

2、批量实体数据插入

插入一组对象            //实例化一组Products对象
            List<Products> list = new List<Products>();
            for (int index = 0; index < 10; index++)
            {
                list.Add(new Products()
                {
                    ProductName = "测试产品" + index
                });
            }

            //批量保存数据
            DbBatch batch = DataAccess.ExampleSession.BeginBatch(10);
            list.ForEach(item =>
            {
                batch.Save(item);
            });

            batch.Process();

3、带事务单个实体插入(MySoft.Data内置实现DbTrans)

插入单个对象(内置事务)            //实例化一个Products对象
            Products product = new Products()
            {
                ProductName = "测试产品1"
            };

            //使用事务进行数据插入
            using (DbTrans trans = DataAccess.ExampleSession.BeginTrans())
            {
                try
                {
                    trans.Save(product);
                    trans.Commit();
                }
                catch
                {
                    trans.Rollback();
                }
            }

4、带事务批量实体插入(MySoft.Data内置实现DbTrans)

插入一组对象(内置事务)            //实例化一组Products对象
            List<Products> list = new List<Products>();
            for (int index = 0; index < 10; index++)
            {
                list.Add(new Products()
                {
                    ProductName = "测试产品" + index
                });
            }

            //使用事务进行批量数据插入
            using (DbTrans trans = DataAccess.ExampleSession.BeginTrans())
            {
                try
                {
                    DbBatch batch = trans.BeginBatch(10);
                    list.ForEach(item =>
                    {
                        batch.Save(item);
                    });
                    batch.Process();

                    trans.Commit();
                }
                catch
                {
                    trans.Rollback();
                }
            }

5、创建外部数据库链接方式插入

插入单个对象(外部链接)            //实例化一个Products对象
            Products product = new Products()
            {
                ProductName = "测试产品1"
            };

            using (System.Data.Common.DbConnection conn = DataAccess.ExampleSession.CreateConnection())
            {
                //插入单个对象
                DataAccess.ExampleSession.SetConnection(conn).Save(product);
            }

注：批量插入可以采用同样的方法处理！

6、创建外部数据库事务方式插入

插入单个对象(外部事务)            //实例化一个Products对象
            Products product = new Products()
            {
                ProductName = "测试产品1"
            };

            using (System.Data.Common.DbTransaction trans = DataAccess.ExampleSession.BeginTransaction())
            {
                try
                {
                    //插入单个对象
                    DataAccess.ExampleSession.SetTransaction(trans).Save(product);
                    trans.Commit();
                }
                catch
                {
                    trans.Rollback();
                }
            }

注：批量插入可以采用同样的方法处理！

item.Detach()方法的高级用法

1、指定某些字段使用数据默认值(不改变原有对象传入的状态)

//插入时排除某些字段
Detach(params Field[] removeFields);

//字段CategoryID不进行插入操作
product.Detach(Products._.CategoryID);

//ExcludeField插入时包括的字段
//调用Field.All或Products._.All的Remove方法排除插入的字段可以返回ExcludeField
//也就是说Detach会排除除Remove以外的所有字段
Detach(ExcludeField field);

//只插入ProductName字段
product.Detach(Field.All.Remove(Products._.ProductName));

说明一下：

不改变原有对象的传状态是指，假如product对象已经在外面调用过如：

在之前调用了product.Detach(Product._.SupplierID);

此处再次调用会在原有的基础上再排除CategoryID，相当于SupplierID与CategoryID都不进行插入操作，而以下DetachAll()方法则是清除之前所有的状态，再进行当前的处理。

2、指定某些字段使用数据默认值(改变原有对象传入的状态)

//插入时排除某些字段
DetachAll(params Field[] removeFields);

//字段CategoryID不进行插入操作
product.DetachAll(Products._.CategoryID);

//ExcludeField插入时包括的字段
//调用Field.All或Products._.All的Remove方法排除插入的字段可以返回ExcludeField
//也就是说DetachAll会排除除Remove以外的所有字段
DetachAll(ExcludeField field); 

//只插入ProductName字段
product.DetachAll(Field.All.Remove(Products._.ProductName));

InsertOrUpdate方法的使用

当用户不知道当前实体是否在数据库中存在时，可以使用此方法。

内部将会根据主键去判断此实体在数据库中是否存在，然后再自动调用相应的方法来进行处理。

代码            Products product = new Products()
            {
                ProductID = 1,
                ProductName = "测试产品"
            };

            DataAccess.ExampleSession.InsertOrUpdate(product);

当然数据插入操作还有其它的方式(自己可以慢慢研究)：

代码            DataAccess.ExampleSession.Insert<Products>(
                new Field[] { Products._.ProductName },
                new object[] { "测试产品" });

            int productID;
            DataAccess.ExampleSession.Insert<Products, int>(
                new Field[] { Products._.ProductName },
                new object[] { "测试产品" }, out productID);

二、InsertCreator数据插入

通过插入创建器同样也可以达到上面的效果，也可以进行泛型方式进行数据插入，一般情况下创建器用于没有建立对象实体时直接对表和字段的操作。

1、通过实体插入实体

代码           InsertCreator ic = InsertCreator.NewCreator()
            .From<Products>()
            .SetEntity<Products>(product);

            DataAccess.ExampleSession.Excute(ic);

2、通过字符串表与字段插入数据

代码            InsertCreator ic = InsertCreator.NewCreator()
            .From("Products")
            .AddInsert("ProductName", "测试产品");

            DataAccess.ExampleSession.Excute(ic);

3、通过字符串表与字段插入数据并返回标识列值

代码            InsertCreator ic = InsertCreator.NewCreator()
                .From("Products")
                .AddInsert("ProductName", "测试产品")
                .SetIdentityField("ProductID");

            int productID;
            DataAccess.ExampleSession.Excute(ic, out productID);

以上通过创建器的方式同样可以用事务来操作 trans.Excute(ic);

这里只是简单的介绍了一下，还有更多的功能需要用户使用时才能体会到。

数据的插入操作就讲解到这里，下一章将讲解数据的修改(Update)操作

有什么问题可以到此处：MySoft组件问题反馈与疑难解答

本文链接

MySoft.Data从入门到精通系列(三)【DbSession的配置】

2010-03-11T08:17:00Z

前一章讲解了如何生成实体，下面就具体来谈谈怎么样来对DbSession进行配置吧。

DbSession（数据会话类）是数据操作的核心，所有数据库的操作都通过它来完成，所以在编写数据库访问层之前得实例化DbSession对象。

下面我们就来认识一下这个DbSession对象。

一、DbSession实例化配置

DbSession两有种方式来进行实例化

1、通过配置文件创建

//指定connectionStrings节的名称来实例化DbSession
public DbSession(string connectName);

这种方式一般用于已经配置好connectionStrings节的用户，如下所示：

<connectionStrings>
    <add name="DataExample" connectionString="Server=(local);Database=Northwind;Uid=sa;Pwd=sa;" 
         providerName="MySoft.Data.SqlServer9.SqlServer9Provider" />
  </connectionStrings>

上面的配置节如果是Web项目，则在web.config中指定，如果是winform项目，则在app.config中的指定

后面的providerName指定数据库链接所使用的驱动。

上面的配置方式只针对.net已经支持的驱动，如Access,SqlServer,Oracle

默认程序集为MySoft.Data.dll

如果是MySql,Firebird,SQLite需要额外的程序集支持，就需要按如下配置:

<connectionStrings>
    <add name="DataExample" connectionString="Server=(local);Database=Northwind;Uid=sa;Pwd=sa;"
         providerName="MySoft.Data.MySql.MySqlProvider, MySoft.Data.MySql" />
  </connectionStrings>

providerName的写法是前面className,后面跟assemblyName。

而且需要添加相关的驱动，如：MySql需要添加MySql.Data.dll与MySoft.Data.MySql.dll

2、通过动态创建DbProvider

//通过创建驱动的方式来实例化DbSession
public DbSession(DbProvider dbProvider);

这种方式一般用于需要动态创建会话对象的用户

DbProvider是一个抽象类，用户还可以自行扩展此驱动。

动态创建DbProvider来实例化DbSession会话:

A、可以传入connectionName来创建驱动，此时connectionName配置节可以不用写providerName;

DbProvider provider = ProviderFactory.CreateDbProvider("DataExample", ProviderType.SqlServer9);
DbSession DataExample = new DbSession(provider);

B、通过传入connectionString来创建驱动，内部ProviderType枚举已经将支持的驱动罗列出来。
DbProvider provider = ProviderFactory.CreateDbProvider(ProviderType.SqlServer9,

"Server=(local);Database=Northwind;Uid=sa;Pwd=sa;");
DbSession DataExample = new DbSession(provider);

C、如果是用户自已实现的驱动，可以通过第三种方式来创建驱动。

DbProvider provider = ProviderFactory.CreateDbProvider(string assemblyName, string className,

string connectionString);
DbSession DataExample = new DbSession(provider);

不过对于一般用于，通过内置的驱动已经完全够用了。

二、DbSession自定义实例化

DbSession实例化有两种方式，直接实例化DbSession,如果内置的DbSession.Default就是其中一种。

DbSession.Default：

这是DbSession内部一个静态的DbSession对象，默认创建自connectionStrings中的最后一个配置节中的数据库链接，如果providerName为空，将默认为SqlServer2000.

下面就讲一下如何来实例化DbSession来进行数据的访问

新建一个MySoftExample.Web项目。

然后新建一个DataAccess的类，用来进行数据的访问类，名字可以自己定义。

讲解也比较费事，直接贴上代码：

实例化DbSession    /// <summary>
    /// 数据库访问类
    /// </summary>
    public static class DataAccess
    {
        /// <summary>
        /// 通过配置节来实例化DbSession
        /// </summary>
        public static readonly DbSession DefaultSession = new DbSession("DataExample");

        /// <summary>
        /// 通过自定义类来实例化DbSession
        /// </summary>
        public static readonly DataExample ExampleSession = new DataExample();

    }

    /// <summary>
    /// DataExample会话类
    /// </summary>
    public class DataExample : DbSession
    {
        public DataExample()
            : base("DataExample")
        {
            this.RegisterSqlLogger(log =>
                {
                    System.IO.File.WriteAllText("c:\\log.txt", log);
                });
        }
    }

进行以上配置后，用户可以有三种方式来操作数据，效果都一样的:

只不过ExampleSession操作数据库会写日志到c:\\log.txt文件。

通过继承可以很方便的实现注册写日志事件。而且对外显示的名字为DataExample，这样是否显得更加清晰和雅观呢。

如果不需要写日志，将注册事件的代码注释掉即可，还有一种方式是通过宏的方式，如下：

注册日志事件    /// <summary>
    /// DataExample会话类
    /// </summary>
    public class DataExample : DbSession
    {
        public DataExample()
            : base("DataExample")
        {
#if DEBUG
            this.RegisterSqlLogger(log =>
                {
                    System.IO.File.WriteAllText("c:\\log.txt", log);
                });
#endif
        }
    }

这样在Release模式下注册事件的代码将失效，这样便于在Debug模式下调试，发布时就不需要写日志了。

DbSession的配置就讲解到这里，下一章将讲述如何使用DbSession来进行数据插入操作！

有什么问题可以到此处：MySoft组件问题反馈与疑难解答

注：此段时间工作上比较忙，故文档更新比较慢，让大家在使用上造成的困扰表示抱歉！

本文链接

MySoft.Data从入门到精通系列(二)【生成实体续(插件的使用)】

2010-03-08T05:40:00Z

前一章讲解了如何使用实体生成直接生成实体，本来此章打算讲解如何使用已经生成的实体来进行开发的，介于园子里很多朋友都不知道如何使用实体的插件，这章就着重讲一下实体生成插件的使用！

前面已经说明了插件如何安装，并针对vs.net2005与vs.net2008修改相应的配置，下面就来说说怎样在vs.net下使用插件，本人所用的开发工具为vs.net 2008。

一、打开vs.net查看插件是否启用

如下图所示，如果插件安装成功，在此处将可以看到以下界面

如果插件未启用，请勾上启用，然后确定！

二、新建一个C#或vb.net的类库项目

此项目只用于生成实体所用，所以我命名MySoftExample.EntityDesign

三、用生成工具生成接口文件

这里不需要勾上【从数据库直接生成实体】,选择右边的表后点击生成实体接口即可。

生成单个文件就在项目中建一个EntitiesDesign.cs文件，然后将代码复制过去

为每个接口生成一个独立的文件，在下方选择刚才项目所在的文件夹，点击生成多个文件即可

具体参照前一单(生成实体)：

到此为止，接口文件就生成完了，如果字段属性有备注说明，这里会自动生成注释的。

四、配置实体生成的xml

首先将lib目录下的EntityDesignConfig.xml文件复制到MySoftExample.Design项目里

<?xml version="1.0" encoding="utf-8" ?>
<EntityDesignConfiguration xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <CompileMode>Debug</CompileMode>
  <InputDllName>EntityDesign.dll</InputDllName>
  <OutputLanguage>C#</OutputLanguage>
  <OutputNamespace>EntityModel</OutputNamespace>
  <EntityCodePath>..\EntityModel\Entities.cs</EntityCodePath>
</EntityDesignConfiguration>

打开此文件将看到上面的配置信息:

1、 CompileMode：表示编译的模式,默认为debug

2、 InputDllName：表示输入实体接口类的dll文件名，即该项目生成的dll的文件名

3、 OutputLanguage：表示输出实体类的语言，默认为C#，也可以为vb.net

4、 OutputNamespace：表示输出实体类的命名空间

5、 EntityCodePath：表示输出实体类文件的路径，即把由实体接口类生成的实体类生成完存放的路径。

支持相对路径，..\表示前一级目录

<EntityCodePath>配置是支持单个文件或文件夹的，如果配置节的路径为文件名，则生成单个文件，如果是目录名则每个接口生成一个实体文件，我这里配置为每个实体生成独立的文件。

我将配置好的xml发出来做为示例

<?xml version="1.0" encoding="utf-8" ?>
<EntityDesignConfiguration xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <CompileMode>Debug</CompileMode>
  <InputDllName>MySoftExample.EntityDesign.dll</InputDllName>
  <OutputLanguage>C#</OutputLanguage>
  <OutputNamespace>MySoftExample.DataEntity</OutputNamespace>
  <EntityCodePath>..\MySoftExample.DataEntity\</EntityCodePath>
</EntityDesignConfiguration>

具体怎样配置请参考MySoft.Data的使用说明

五、将接口通过插件来生成实体

配置好以上xml后，点击生成接口项目，此时只要配置没有问题，则会自动生成所需的文件。

其实插件会自动调用MySoft.Tools.EntityDesign.exe来生成。

注意：如果设置的是生成文件夹，则需要将生成的文件包括在项目中

如果设置的生成文件，则之前要先创建好这个文件在实体项目中！

通过接口来生成实体还有更加强大的功能，如下所示：

给属性加上注释或使用枚举    /// <summary>
    /// 用户类型
    /// </summary>
    public enum UserType
    {
        /// <summary>
        /// 普通的
        /// </summary>
        General,
        /// <summary>
        /// 超级用户
        /// </summary>
        Admin
    }

    /// <summary>
    /// 用户信息
    /// </summary>
    [Description("用户信息")]
    public interface User : IEntity
    {
        [PrimaryKey]
        [Description("用户ID")]
        int UserID { get; }

        [Description("用户名")]
        string UserName { get; set; }

        [Description("用户类型")]
        UserType UserType { get; set; }
    }

通过接口的方式可以给属性或类加上注释说明，必须通过Description来添加注释，否则无法附加到生成的实体中。

本组件还支持枚举的方式进行增删改查，这样对用户的使用上会更加简便！

如果数据库中对字段进行增删改，只需要将此接口中的属性更改即可

还可以通过以下方式处理：

使用Mapping来修改字段的映射    /// <summary>
    /// 用户信息
    /// </summary>
    [Description("用户信息")]
    [Mapping("User")]
    public interface UserEntity : IEntity
    {
        [PrimaryKey]
        [Description("用户ID")]
        [Mapping("UserID")]
        int ID { get; }

        [Description("用户名")]
        [Mapping("UserName")]
        string Name { get; set; }

        [Description("用户类型")]
        [Mapping("UserType")]
        UserType Type { get; set; }
    }

注：此枚举需要放在独立的项目中，接口项目与实体项目都需要引用此枚举！

对接口的修改需要重新生成实体。

插件的使用到此为止，下一章将讲解如何配置DbSession

如果要使项目编译成功，需要添加 MySoft.Data.dll到此项目中

有什么问题可以到此处：MySoft组件问题反馈与疑难解答

本文链接