NLite.Data的应用

　　前段时间，我们对NLite.Data进行了开发，其NLite.Data Framework 是一个轻量简单易用的开源Linq ORM数据访问组件，支持Nullable类型和枚举类型，对Linq的谓词提供了完美的支持，旨在让绝大部份的主流数据库都使用 Linq 来进行程序开发，让开发人员访问数据库从SQL中解放出来，易学易用上手快，配置简单，并且提供了源代码下载，方便定制。支持多数据库，目前支持Access、SQLServer、SqlCE、SQLite、MySQL、ORACLE，未来还会支持更多的数据库。现在进度将近尾声，下面我对此组件的使用方法和步骤做下说明：

     

      1.  安装NLite Linq ORM Framework 

　　　  在Package Manager Console控制台中输入下列命令：

　　　  PM> Install-Package NLite.Data 

　　　 备注：Nuget安装方法和步骤:  http://docs.nuget.org/docs/start-here/installing-nuget

　　　　　　Nuget使用说明:  http://docs.nuget.org/docs/start-here/using-the-package-manager-console

　　2.  连接字符串配置

　　　  在配置文件中配置连接数据库字符串，以Sql Server Compact 为例

 <configuration>
   <connectionStrings>
     <add providerName="System.Data.SqlServerCe.3.5" 
          name ="Demo" 
          connectionString="Data Source=DataBase\MyDatabase#1.sdf;Persist Security Info=True;pwd = 123"/>
   </connectionStrings>
 </configuration>

 

　　3.  数据库表设计

　　　　  列名          数据类型          长度          允许空值           是否自增         主键

 ID             int                  4                 否                  是            是

Name        nvarchar         10                否                  否            否

Gender      real                 4                 是                  否            否

 Age           int                  4                 是                  否            否

 

　   4.  实体类的配置

          首先引用NLite.Data.dll组件，然后添加属性(这里必须为属性，不可为字段)，实体类中的属性要与数据库表中的列相对应。下面举例说明，我在数据库中建了一个名为User的表，包含ID、Name、Gender、Age列。那么，在实体类中的配置如下：

          标准配置：

      [Table(Name = "User")]
      public class User
      {
            [Id(IsDbGenerated = true)]
            public int ID { get; set; }
            [Column(Name = "Name")]
            public string Name { get; set; }
            [Column(Name = "Gender")]
            public bool Gender { get; set; }
            [Column(Name = "Age")]
            public int Age { get; set; }
      }

         缺省配置：

      public class User
      {
            public int ID { get; set; }
            public string Name { get; set; }
            public bool Gender { get; set; }
            public int Age { get; set; }
      }

　　　 说明：如果其他属性名或类名与数据库表中的列名或表名一致，则实体类中相应的属性或类名上面可以不写标志，可以直接映射。不清楚可以参考：http://ndo.codeplex.com/ 下的“设计理念”

　　5.  写Sql语句之前的配置

　 写Sql语句之前还需要配置，以上面的User表为例：

connectionStringName = "Demo";
cfg = DbConfiguration
     .Configure(connectionStringName)//通过connectionStringName对象创建DbConfiguration对象（可以用于配置文件中有多个数据库连接字符串配置）
     .AddClass<Model.User>()//注册实体到数据表的映射关系
     ;

 

　　6.  增、删、改、查代码示例 

•  添加用户示例

Model.User user = new Model.User
{
     Name = "新记录",
     Age = 23,
     Gender = true
};
using (var ctx = cfg.CreateDbContext())
      ctx.Set<User>().Insert(user);

　　　　 语句描述：实例化一个Use对象(ID为自增，可不写)，是以对象的形式插入到数据库中，Insert方法返回一个整型值，成功为1，否则为0。

　　　　 注：该语句生成的sql语句为：

INSERT INTO [User] ( [Name], [Gender],[Age] )
VALUES (@p0, 1 , 23)
-- p0:(DbType = String,Value = 新记录) 

• 删除用户示例

using (var ctx = cfg.CreateDbContext())
{
   ctx.Set<User>().Delete(p=> p.ID == 5);
}

　　　　 语句描述：该方法是通过唯一标识ID删除数据库中的一条记录，Delete方法返回一个整型值，成功为1，否则为0。

 注：该语句生成的sql语句为：

DELETE FROM [User]
WhERE ( [ID] = 5 )

• 修改用户示例

Model.User user = new Model.User
{
     ID = 5,
     Name = "修改新记录",
     Age = 24,
     Gender = false
};
using (var ctx = cfg.CreateDbContext())   
     ctx.Set<User>().Update(user);

　　　　 语句描述：实例化一个Use对象（其中包含唯一的标识），是以对象的形式通过唯一标识找到该记录并更新数据库表中的记录，Update方法返回一个整型值，成功为1，否则为0。

 　　　　 注：该语句生成的sql语句为：　　　　 

UPDATE [User]
SET [Name] = @p0, [Gender] = 0, [Age] = 24
WHERE ( [ID] = 5 )
-- p0:( DbType = String,Value = 修改新记录 )

• 查询用户示例

using (var ctx = cfg.CreateDbContext())
    ctx.Set<User>().ToArray();
//查询所有的记录

using (var ctx = cfg.CreateDbContext())
    ctx.Set<User>().Find(5);
//查询ID为5的这条记录

　　　　 语句描述：第一条语句是查询表中所有的记录，存储到User[]数组里面; 第二条语句查询ID为5的记录。

　　　　 注：语句生成的sql语句分别为： 

SELECT t0.[ID], t0.[Name], t0.[Gender], t0.[Age]
FROM [User] AS t0
--查询表中所有的记录
 
SELECT t0.[ID], t0.[Name], t0.[Gender], t0.[Age]
FROM [User] AS t0
WHERE ( t0.[ID] = 5 )
 --查询ID为5的这条记录

 

       示例源代码下载：https://files.cnblogs.com/xiaocaibaodao/Demo.rar 

       关系查询Demo下载：https://files.cnblogs.com/xiaocaibaodao/Demo1.rar