版本
1.3 [2007-4-24]
簡介
本教程介紹NBearV3中的VS2005代碼生成插件的使用。
目標
通過本教程，讀者應能夠全面掌握NBearV3中的VS2005代碼生成插件的使用。
代碼
本教程演示的EntityDesignToEntityConfig.xml文件示例代碼，包含於可以從下載的NBearV3最新源碼zip包中的tutorials\VsPlugin_Tutorial目錄中。因此，在使用本教程的過程中如有任何疑問，可以直接參考這些代碼。
時間
<10分鐘。
正文
要使用NBear的Vs插件，只需要執行兩個步驟：
首先，需要安裝NBear的Vs插件。只需要雙擊dist\SetupNBearVsPlugin.exe文件，就能完成安裝。
接著，在實體設計工程的項目根目錄中，創建一個名為EntityDesignToEntityConfig.xml的文件。也可以直接復制tutorials\VsPlugin_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 Files\Microsoft SQL Server\80\Tools\Binn</SqlServerFolder>
<ServerName>.</ServerName>
<UserID>sa</UserID>
<Password>sa</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 Files\Microsoft SQL Server\90\Tools\Binn。
//本文結束
