DataMapper 1.6.1文档：http://ibatis.apache.org/docs/dotnet/datamapper/index.html
DataAccess 1.9.1文档：http://ibatis.apache.org/docs/dotnet/dataaccess/index.html
里面基本上有很多关键的问题都说的很清楚。
2.如果你下载了NPetShop或NPetShop2代码，或者参考一些朋友先前的配置文件，注意这些项目或者文章使用的配置文件很可能已经
陈旧，不适用于ibatis.net 1.3以上版本了。一定按照官方的文档中的配置方式配置。切记不可运行的一切的根源可能不在于你的代
码，而在于配置文件没有配置好。尤其要注意每个配置文件的头部信息，特别是xmlns和xmlns:xsi，切记对照官方文档检查清楚。
3.一定要正确的引用Castle.DynamicProxy类库，这个是关键的关键，在官方文档中有详细的描述。
4.当碰到这个出错提示ibatis.net This SQL map does not contain a MappedStatement named
往往是没有加载SqlMap.config所导致，最简单的验证方法是将SqlMap.config中
<sqlMaps>
<sqlMap url="E:\Projet\NPetshop\Source\NPetshop.Web\Maps\Category.xml"/>
</sqlMaps>
url的配置改成一个不存在的.xml文件，这时启动项目后肯定报错找不到文件。
5.如果报System.NullReferenceException: 未将对象引用设置到对象的实例的错误，即：
行 35: DomDaoManagerBuilder builder = new DomDaoManagerBuilder();
行 36: builder.ConfigureAndWatch("dao.config", handler);
一般都是没有正确的引用Castle.DynamicProxy类库。
6.最佳参看的示例在http://www.cnblogs.com/anderslly/archive/2007/08/07/npetshopsourcecode.html感谢作者，重写了
NPetShop的示例。
结合上面示例中的IbatisNet配置文件，下面对配置文件中各节点的说明：
<?xml version="1.0" encoding="utf-8"?>
<sqlMapConfig xmlns="http://ibatis.apache.org/dataMapper" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" >
<!-- Rem : If used via a DataAccess context, properties tag will be ignored
<properties resource="http://www.cnblogs.com/database.config"/> -->
<properties embedded="database.config, IBatisNetDemo"/>
<settings>
<setting useStatementNamespaces="${useStatementNamespaces}"/>
<setting cacheModelsEnabled="true"/>
<setting validateSqlMap="false"/>
</settings>
<!-- Optional if resource -->
<providers embedded="providers.config,IBatisNetDemo"/>
<!-- ==== SqlClient configuration ========= -->
<!-- Rem : If used via a DataAccess context, database tag will be ignored -->
<database>
<!-- Optional ( default ) -->
<provider name="sqlServer1.1"/>
<dataSource name="iBatisNet" connectionString="da
</database>
<sqlMaps>
<!-- user via embedded-->
<sqlMap embedded="Map.SqlClient.Person.xml,IBatisNetDemo"/>
</sqlMaps>
</sqlMapConfig>
1. properties节点
可以根据需要配置一些常量属性。如果这些属性有很多的话可以单独写一个文件里面，再通过resource（或url,embedded分别是引用url和编译在程序中的资源文件）属性引用进来
properties 节点参数
参数 |
描述 |
resource |
指定the properties文件从application的根目录进行加载 resource="properties.config" |
url |
指定the properties文件从文件的绝对路径进行加载 url="c:\Web\MyApp\Resources\properties.config" -or- url="file://c:\Web\MyApp\Resources\properties.config" |
embedded |
指定文件可以作为程序集的资源文件进行加载' embedded=" database.config, IBatisNetDemo” |
上面例子中Properties文件的配置如下：
<?xml version="1.0" encoding="utf-8" ?>
<settings>
<!-- User application and configured property settings go here.-->
<!-- To run tests, create a file named DataBase.config
with your own value for datasource.
(don't included it in the solution and don't commit it in SVN)
-->
<add key="userid" value="sa" />
<add key="password" value="" />
<add key="database" value="Northwind" />
<add key="datasource" value="localhost" />
<add key="selectKey" value="select @@IDENTITY as value" />
<add key="directory" value="Maps" />
<add key="useStatementNamespaces" value="false" />
</settings>
下面解释一下这个文件的节点参数
Property节点参数
参数 |
描述 |
key |
定义key (variable) 名字 key="username"
|
value |
定义DataMapper 中使用的 key的值 value="mydbuser"
|
2. setting节点
Setting节点参数
参数 |
描述 |
cacheModelsEnabled |
是否启用sqlMap上的缓存机制 Example: cacheModelsEnabled=”true” Default: true (enabled)
|
useStatementNamespaces |
是否使用Satement命名空间，这里的命名空间指的是映射文件中sqlMap节点的namespace属性，如上例中针对Person表的映射文件sqlMap节点 <sqlMap namespace="Person" xmlns="http://ibatis.apache.org/mapping" xmlns:xsi=http://www.w3.org/2001/XMLSchema-instance> 这里,指定了此sqlMap节点下定义的操作均丛属于“Person”命名空间在useStatementNamespaces=”true”的情况下，Statement调用需追加命名空间，如：sqlMap.Update(“Person.UpdatePerson”,person);否则直接通过Statement名称调用即可，如sqlMap.Update(“UpdatePerson”,person);但请注意此时需要保证所有映射文件中，statement定义无重名 Example: useStatementNamespaces=”false” Default: false (disabled)
|
validateSqlMap |
是配置要不要启示SqlMapConfig.xsd schema验证映射文件. Example: validateSqlMap=”false” Default: false (disabled)
|
3. provider节点
配置数据驱动提供类配置文件的路径和文件名，通过resource（或url, embedded分别是引用url和编译在程序中的资源文件）属性引用进来，参数的含义同properties.
ADO.NET是通过数据访问提供程序（Provider）访问数据库。IBatisNet使用的是插件式结构来使用这些数据库提供程序，每一个Provider对应于providers.config文件中定义的一个provider项。1.3版本的Provider.config文件中定义了已经实现的16个provider,通过设置这个文件中的几个参数来决定使用哪个数据库提供程序。
提供程序要求安装相关类库，每一个
provider 元素都有 "enabled" 属性来控制是否启用这个 providers. 一个 provider 可以通过 “ default “属性标识为默认的提供程序。4. database节点
数据库的信息，包括使用哪些数据库驱动和数据连接字符串的配置。
Database节点参数
参数 |
描述 |
provider |
数据库访问所使用的provider.config文件定义的provider |
dataSource |
特定的数据库连接字符串 |
5. typeHandler节点
定义数据库类型到dotnet数据类型的处理，不同的数据库都有一些特殊的数据库字段类型需要特殊处理，就可以通过这个功能实现。比如说Blob字段在不同的数据库中处理不一样。大家可以去看看Ibatisnet源代码就清楚这个功能的实现原理，对于我们的设计会有很大的启发
6. sqlMaps节点
sqlMap节点指定了映射文件的位置，配置中可以出现多个sqlMap节点，以指定项目内所包含的所有映射文件
