宣布NBearLite v1.0.0: 提供强类型查询语法的非ORM数据访问组件 [8/2 更新至v1.0.0.9 beta – 修复NBearLite参考手册某些操作系统打开错误的题材]

NBearLite是一个基于NBear的强类型查询内核的.NET
2.0开源(BSD协议)的通用数据访问组件。由NBear.orgTeddy保障。NBearLite继承了和更为简化扩张了NBear中好像LINQ的强类型数据库查询语法(补助CRUD简单询问及GroupBy、InnerJoin,Paging等常用复杂查询),简化了命名空间、代码架构,并愈加简化了用户拔取,对已有代码也从没任何入侵。NBearLite不是一个ORM工具,它不关乎实体类,NBearLite的具备查询重返Scalar/DataSet/IData里德(Reade)r。

运用演示
无论在新建的主次依旧已有的程序中使用NBearLite,步骤都差不多,分外简单。

1、使用NBearLite提供的NBearLite.QueryColumnsGenerator.exe工具从已有数据库(可以是SqlServer、Oracle、MsAccess、MySql、Sqlite或PostgreSql),为表和视图生成强类型查询匡助类,并将转移的代码文件引用到项目工程。

2、在类型中引用NBearLite.dll(该DLL内置了SqlServer、Oracle和MsAccess的DbProvider,假若急需采纳MySql、Sqlite或PostgreSql数据库,则还亟需引用NBearLite.AdditionalDbProviders.dll)。

3、在类型的Web.config或App.config中的ConnectionStrings配置块中添加connectionstring。添加的语法可以和ADO.NET配置的业内语法一样,也得以简化设置,将providerName设为空(默认为sqlserver),
sqlserver, sqlserver2005, msaccess, oracle, mysql,sqlite或postgresql

4、接着就足以一直在项目中实例化NBearLite.Database对象,并拔取Database对象访问数据库了。

切切实实的利用代码可以参见NBearLite.Test工程。

例如:

在NBearLite.Test工程中,山姆pleQueryColumnsDefinition.cs文件中保存了由NBearLite.QueryColumnsGenerator.exe工具生成的诺思wind数据库的所有表和视图的强类型查询援助类。

在DatabaseTest.cs文件中,包含了有的询问演示:

 1sqlite 1        [TestMethod]
 2sqlite 2        public void TestInsert()
 3sqlite 3sqlite 4        sqlite 5{
 4sqlite 6            Assert.AreEqual(1, db.Insert(Northwind.Categories).AddColumn(Northwind.Categories.CategoryName, “test1”).Execute());
 5sqlite 7            Assert.IsTrue(db.Insert(Northwind.Categories).AddColumn(Northwind.Categories.CategoryName, “test1”).ExecuteReturnAutoIncrementID(Northwind.Categories.CategoryID) > 1);
 6sqlite 8        }
 7sqlite 9
 8sqlite 10        [TestMethod]
 9sqlite 11        public void TestUpdate()
10sqlite 12sqlite 13        sqlite 14{
11sqlite 15            Assert.AreEqual(1, db.Insert(Northwind.Categories).AddColumn(Northwind.Categories.CategoryName, “test1”).Execute());
12sqlite 16            Assert.IsTrue(db.Update(Northwind.Categories).AddColumn(Northwind.Categories.CategoryName, “test1”).Where(Northwind.Categories.CategoryName == “test1”).Execute() > 0);
13sqlite 17        }
14sqlite 18
15sqlite 19        [TestMethod]
16sqlite 20        public void TestDelete()
17sqlite 21sqlite 22        sqlite 23{
18sqlite 24            Assert.AreEqual(1, db.Insert(Northwind.Categories).AddColumn(Northwind.Categories.CategoryName, “test111”).Execute());
19sqlite 25            Assert.IsTrue(db.Delete(Northwind.Categories).Where(Northwind.Categories.CategoryName == “test111”).Execute() > 0);
20sqlite 26        }
21sqlite 27
22sqlite 28        [TestMethod]
23sqlite 29        public void TestSelect()
24sqlite 30sqlite 31        sqlite 32{
25sqlite 33            DataSet ds = db.Select(Northwind.Categories).ToDataSet();
26sqlite 34            Assert.IsTrue(ds.Tables[0].Rows.Count > 0);
27sqlite 35            ds = db.Select(Northwind.Categories, Northwind.Categories.CategoryName).Where(Northwind.Categories.CategoryID > 0).ToDataSet();
28sqlite 36            Assert.IsTrue(ds.Tables[0].Rows.Count > 0);
29sqlite 37            ds = db.Select(Northwind.Categories, Northwind.Categories.CategoryName).GroupBy(Northwind.Categories.CategoryName).OrderBy(Northwind.Categories.CategoryName.Desc).SetSelectRange(2, 2, Northwind.Categories.CategoryName).ToDataSet();
30sqlite 38            ds = db.Select(Northwind.Categories, Northwind.Categories.__Alias(“CategoriesAlias”).CategoryName).Join(Northwind.Categories, “CategoriesAlias”, Northwind.Categories.CategoryID == Northwind.Categories.__Alias(“CategoriesAlias”).CategoryID).
31sqlite 39                SetSelectRange(2, 2, Northwind.Categories.CategoryID).Where(Northwind.Categories.CategoryName.Length > 0 && Northwind.Categories.__Alias(“CategoriesAlias”).Description != null).
32sqlite 40                ToDataSet();
33sqlite 41        }

前多少个Test都相比容易精晓。TestSelect()中,分别演示了简要询问,分页GroupBy查询和一个自关联Join分页查询。

除此之外以上演示的代码之外,还可以够行使Database.CustomSql()/Database.StoredProcedure()方法查询自定义sql或存储过程。

其余,NBearLite.QueryColumnsGenerator.exe工具本身也是一个运用NBearLite查询数据库的其实的实例程序。

下载

NBearLite_v1.0.0.9 Beta 及普通话版NBearLite完全参考手册
修订

**7/21 更新至v1.0.0.2 beta – 新增PostgreSql
DbProvider,Insert/Update/Select/Delete方法的参数有一些修改,请小心参考上述已履新的的实例代码。
7/22 更新至v1.0.0.3 beta – 修复PostgreSql DbProvider中的Bug。
7/24 更新至v1.0.0.4 beta –
全面协理SqlServer,Oracle,MySql,PostgreSql数据库存储过程调用代码生成(C#/VB.NET)接纳示例
7/27 更新至v1.0.0.5 beta – 支持Sub Query查询

Sub Query示例:

**

 1sqlite 42            //SELECT * FROM [Products] WHERE ([Products].[CategoryID] IN ((SELECT TOP 10 [Categories]sqlite,.[CategoryID] FROM [Categories] ORDER BY [Categories].[CategoryID])))    
 2sqlite 43            DataSet ds = db.Select(Northwind.Products)
 3sqlite 44                .Where(Northwind.Products.CategoryID.In
 4sqlite 45                (
 5sqlite 46                    db.Select(Northwind.Categories, Northwind.Categories.CategoryID).SetSelectRange(10, 0, Northwind.Categories.CategoryID).ToSubQuery())
 6sqlite 47                )
 7sqlite 48                .ToDataSet();
 8sqlite 49
 9sqlite 50            //SELECT * FROM [Products] WHERE ([Products].[CategoryID] = (SELECT TOP 1 [Categories].[CategoryID] FROM [Categories] ORDER BY [Categories].[CategoryID]))
10sqlite 51            ds = db.Select(Northwind.Products)
11sqlite 52                            .Where(Northwind.Products.CategoryID ==
12sqlite 53                            (
13sqlite 54                                db.Select(Northwind.Categories, Northwind.Categories.CategoryID).SetSelectRange(1, 0, Northwind.Categories.CategoryID).ToSubQuery())
14sqlite 55                            )
15sqlite 56                            .ToDataSet();
16sqlite 57            Assert.IsTrue(ds.Tables[0].Rows.Count > 0);

**7/28 更新至v1.0.0.6 beta – 支持Save
DataTable/DataRow

Save DataTable/DataRow示例:

**

 1sqlite 58SelectSqlSection selectSection = db.Select(Northwind.Categories)
 2sqlite 59  .Where(Northwind.Categories.CategoryID == catID)
 3sqlite 60  .OrderBy(Northwind.Categories.CategoryID.Desc)
 4sqlite 61  .SetSelectRange(1, 0, Northwind.Categories.CategoryID);
 5sqlite 62DataTable dt = selectSection.ToDataSet().Tables[0];
 6sqlite 63
 7sqlite 64dt.Rows[0][“CategoryName”] = “modified”;
 8sqlite 65
 9sqlite 66//save a modified row
10sqlite 67db.Save(selectSection.ToDbCommand(), 10, dt);
11sqlite 68
12sqlite 69dt.Rows[0][“CategoryName”] = “modified2”;
13sqlite 70
14sqlite 71DataRow newRow = dt.NewRow();
15sqlite 72newRow[“CategoryName”] = “new”;
16sqlite 73dt.Rows.Add(newRow);
17sqlite 74
18sqlite 75//save 1 modified row and insert a new row
19sqlite 76db.Save(selectSection.ToDbCommand(), tran, 0, dt.Rows[0], dt.Rows[1]);

7/29 更新至v1.0.0.7 beta –
发表中文版NBearLite完全参考手册

7/30 更新至v1.0.0.8 beta – 为Stored
Procedure包装方法扩大带Transaction重载
8/2 更新至v1.0.0.9 beta –
修复NBearLite参考手册某些操作系统打开错误的题材

网站地图xml地图