NBearV3——VsPlugin使用教程

　　版本

　　1.3 [2007-4-24]

　　简介

　　本教程介绍NBearV3中的VS2005代码生成插件的使用。

　　目标

　　通过本教程，读者应能够全面掌握NBearV3中的VS2005代码生成插件的使用。

　　代码

　　本教程演示的EntityDesignToEntityConfig.xml文件示例代码，包含于可以从http://nbear.org下载的NBearV3最新源码zip包中的tutorialsVsPlugin_Tutorial目录中。因此，在使用本教程的过程中如有任何疑问，可以直接参考这些代码。

　　时间

　　<10分钟。

　　正文

　　要使用NBear的Vs插件，只需要执行两个步骤：

　　首先，需要安装NBear的Vs插件。只需要双击distSetupNBearVsPlugin.exe文件，就能完成安装。

　　接着，在实体设计工程的项目根目录中，创建一个名为EntityDesignToEntityConfig.xml的文件。也可以直接复制tutorialsVsPlugin_Tutorial下的EntityDesignToEntityConfig.xml文件，再进行必要的修改。

　　典型的EntityDesignToEntityConfig.xml文件内容如下：

<?xml version="1.0" encoding="utf-8" ?>
<EntityDesignToEntityConfiguration xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<CompileMode>Debug</CompileMode>
<InputDllName>EntityDesigns.dll</InputDllName>
<OutputNamespace>Entities</OutputNamespace>
<OutputLanguage>C#</OutputLanguage>
　　<!--<OutputCodeFileEncoding>utf-8</OutputCodeFileEncoding>-->
<EntityCodePath>..Entities/Entities.cs</EntityCodePath>
<EntityConfigPath>..website/EntityConfig.xml</EntityConfigPath>
<SqlSync enable="false">
　　<SqlServerFolder>C:Program FilesMicrosoft SQL Server80ToolsBinn</SqlServerFolder>
　　<ServerName>.</ServerName>
　　<UserID>sa</UserID>
　　<Password>1</Password>
　　<DatabaseName>tempdb</DatabaseName>
</SqlSync>
</EntityDesignToEntityConfiguration>

　　该文件的内容比较容易理解，从上往下：

　　CompileMode表示需要读取的dll所在的output目录是Debug还是Release。

　　InputDllName表示实体设计dll的名称。

　　OutputNamespace等价于EntityDesignToEntity.exe工具的OutputNamespace。

　　OutputLanguage为生成的Entities的语言，可选的值为C#或VB.NET。

　　OutputCodeFileEncoding为生成到EntityCodePath指定的代码文件的encoding，如果不指定则为操作系统的默认编码。

　　EntityCodePath

　　表示生成的具体的实体代码所在的代码文件。

　　EntityConfigPath表示生成的实体配置代码所在的xml文件。

　　SqlSync中的内容设置了，是否需要及如何连接数据库，从而在设计实体有变化时，自动同步数据库中的表和视图。各选项应该无需过多解释，大家一看就能明白。

　　使用效果

　　要体验VsPlugin插件的强大功能，大家只需打开v3.3.7及以后版本中的tutorials目录中的ORM和IoC等教程的sln，编译任意的EntityDesigns工程，您将注意到，在EntityDesigns工程成功编译之后，Entities.cs和EntityConfig.xml代码，甚至相关的数据库表示图结构就自动更新同步了。所有这些过程原来都需要用户手工使用EntityDesignToEntity.exe工具来生成同步，现在，所有的一切，都可以由VsPlugin帮你来做。

　　注意

　　请注意修改所有教程中的EntityDesignToEntityConfig.xml中的SqlSync中的SqlServerFolder的值和相应的ServerName，UserID和Password。或者可以暂时将SqlSync的enable设为false。

　　对于SqlServer2005，一般SqlServerFolder的值应该设为X:Program FilesMicrosoft SQL Server90ToolsBinn。

　　//本文结束