Dapper-小型ORM之王（C#.NET）

ORM:对象关系映射器，它直接将数据库映射到C#对象。

有不少ORM框架可用，Dapper是其中之一，被称为ORM之王。

下面是Dapper主要的一些功能：

• 速度快，性能好;
• 更少的代码行
• 对象映射
• 静态对象绑定
• 动态对象绑定
• 易于处理Sql语句
• 易于处理存储过程
• 直接操做IDBConnection类，该类直接向数据库提供平滑性和运行查询，而不是像在EF和ADO.NET中那样使用各类对象传递数据。
• 多个查询支持
• 支持存储过程
• 批量处理数据插入
• 容许基于多个输入获取多个数据

为何选择Dapper

• Dapper是第二快的ORM

图片参照: Dapper dotnet.

• 直接使用IDBConnection对象执行CRUD操做；
• 经过数据库提供查询静态和动态数据；
• 获取简单或复杂数据类型的通用结果;
• Dapper容许同时存储批量数据。

如何安装Dapper

在Visual Studio中，建立一个新的控制台项目，并在解决方案资源管理器中右键单击引用，选择 “管理Nuget包...”包管理器，而后搜索Dapper，并使用NuGet包管理器控制台命令“install-package Dapper”，这将在项目中安装Dapper。

Dapper如何工做

主要包含三个步骤

第一步：使用链接字符串建立一个IDBConnection对象；

第二步：编写一个查询并将其存储在一个普通的字符串变量中；

第三步：调用db.execute()并传递查询，完成。

在下面的示例中，咱们还将探索许多其余的方法。

对于本例，我有一个名为“ContactDB”的数据库，库中包含一个名为“Contacts”的表，让咱们使用Dapper对Contacts表进行CRUD操做。

建立一个控制台应用程序并安装Dapper，并包含Dapper的命名空间。

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using Dapper;

namespace DapperORMBlog
{
   public class Program
    {
        static void Main(string[] args)
        {
        }
    }
}

示例1：

获取全部数据并打印到控制台

第一步：建立IDbConnection类的对象和SqlConnection的新实例。

static IDbConnection db = new SqlConnection(ConfigurationManager.ConnectionStrings["SqlServerConnString"].ConnectionString);

SqlServerConnString是链接字符串名称，能够配置在程序中的App.config中。

<connectionStrings>
    <add name="SqlServerConnString" providerName="System.Data.SqlClient" connectionString="Data Source=.\;Initial Catalog=ContactDB;Integrated Security=True;MultipleActiveResultSets=True" />
  </connectionStrings>

第二步：写一个查询，并将其存储到一个string类型的变量中

String query = "select * from contacts"; 

第三步：在db实例上启动查询，并将泛型返回类型转换为联系人实体List

(List<Contact>)db.Query<Contact>(query)

只要使用这三个步骤，咱们就能够从Contacts表中检索出全部的数据，能够在须要的地方去填充这些数据。能够将整个列表打印到Winform程序的GridView或者WPF,更或者将整个列表传递给任何外部的WCF.

对于这个示例，咱们将其打印到控制台

List<Contact> lstContact= (List<Contact>)db.Query<Contact>(query);
            foreach (var item in lstContact)
            {
                Console.WriteLine(item.FirstName + " " + item.LastName+"\n");
            }
            Console.ReadKey();

结果：

示例2：

给Contacts表中插入数据，一样包含三步

 第一步：建立IDbConnection类的对象和SqlConnection的新实例。

static IDbConnection db = new SqlConnection(ConfigurationManager.ConnectionStrings["SqlServerConnString"].ConnectionString);

第二步：

  string query = @"Insert into contacts values (@FirstName, @LastName, @Email, @Company, @Title);  
Select Cast (Scope_Identity() as int)";

在这里，咱们包含两个查询来获取Contacts表最后插入的id值。

在db实例上启动查询，咱们将得到一个int类型的返回值，所以将其存储到int变量中，并将contact对象和查询语句传递过去,以下所示。

 int id = db.Query<int>(query, contact).Single();

在这三个简单步骤中，数据将被插入到数据库中。

按 Ctrl+C 复制代码

按 Ctrl+C 复制代码

查看数据库多了一条记录，说明插入成功

示例3：如今，让咱们经过在where子句中传递一个id，从Contacts表中获取一条记录

 第一步：建立IDbConnection类的对象和SqlConnection的新实例。

static IDbConnection db = new SqlConnection(ConfigurationManager.ConnectionStrings["SqlServerConnString"].ConnectionString);

第二步：

    string query = "select * from contacts where id = @id";

第三步：在db实例上启动查询，咱们将得到一条联系人记录，并将其传给contact对象进行保存

            Contact cont = (Contact)db.Query<Contact>(query, new { id = 7 }).SingleOrDefault();

备注：一样的方法，咱们能够对数据库进行Update和Delete操做

咱们甚至能够用db.Execute()

db.Query()和db.Execute()之间主要的区别是，用db.Query()咱们能够按照咱们的设计获取返回值，由于它是一个通用的方法，而db.Execute()不是一个通用的方法，所以它只能返回int

进一步使用Dapper

• 咱们也会遇到一次须要处理多个表的需求，例如一次查询多个表或者之外键获取数据
• 咱们能够用Dapper同时访问多个表，而且十分平滑
• 传递对象列表，Dapper本事能够识别出是批量插入
• 根据各类参数获取数据，Dapper会自动将数组转换成CSV,并返回一个List对象

示例4：

下面假如说我已经有另外一张名为“Address”的表

咱们将在两个表上同时执行CRUD操做，使用相同的ContactId,即Contacts表中的主键，Adress表中的外键

如今让咱们经过传递Id从Contacts表和Adress表中获取多条数据

第一步和以前全部示例的第一步相同，咱们从第二步开始

第二步：

string query = "select * from contacts where id = @id ; select * from address where ContactId = @id;";

第三步：db实例上启动查询

using (var multipleresult = db.QueryMultiple(query, new { id = 1 }))
            {
                var contact = multipleresult.Read<Contact>().SingleOrDefault();
                var Addresses = multipleresult.Read<Address>().ToList();
                if (contact != null && Addresses != null)
                {
                    contact.Addresses.AddRange(Addresses);
                }
            }

以上三步你将 能够从多个表中得到多条记录

示例5：

让咱们使用存储过程访问数据库

我有一个存储过程，声明一个参数（ID）,而且基于ID返回Contact数据和Address数据

Use ContactDB
SET ANSI_NULLS ON
GO
SET QUOTED_IDENTIFIER ON
GO

CREATE PROCEDURE [dbo].[sp_GetContact_Address]  
    @Id int 
AS
BEGIN
select * from contacts where id = @Id ;   
select * from Address where ContactId = @Id; 
END
GO

用Dapper调用存储过程

第一步同其余示例

在这里咱们不须要写任何的query语句，相反的咱们将调用数据库内的存储过程

在这里咱们将作的更改是传递一个存储过程的名称而不是查询语句，并传递一个名称为command type的参数。

第二步：在db实例上启动查询

using (var multipleresult = db.QueryMultiple("sp_GetContact_Address", new { id = 1 }, commandType: CommandType.StoredProcedure))
            {
                var contact = multipleresult.Read<Contact>().SingleOrDefault();
                var Addresses = multipleresult.Read<Address>().ToList();
                if (contact != null && Addresses != null)
                {
                    contact.Addresses.AddRange(Addresses);
                }
            }

仅仅两步，就 能够成功的调用数据库中的存储过程

示例6：

当咱们须要处理运行时对象时，还能够将动态对象或者值传递给存储过程

下面这个存储过程会给Contacts表里增长一条记录

use ContactDB
SET ANSI_NULLS ON
GO
SET QUOTED_IDENTIFIER ON
GO

CREATE PROCEDURE [dbo].[SaveContact] 
    @Id int output,
    @FirstName nvarchar(50),
    @LastName nvarchar(50),
    @Email nvarchar(50),
    @Company nvarchar(50),
    @Title nvarchar(50)


AS
BEGIN
    INSERT INTO [dbo].[Contacts]  
           ([FirstName],[LastName],[Company],[Title],[Email]) VALUES  
           (@FirstName, @LastName, @Company, @Title, @Email);  
        SET @Id = cast(scope_identity() as int)  
END
GO

下面演示了如何使用Dapper经过传递动态参数调用存储过程

第一步同其余示例

第二步：建立一个动态对象并将值传递给该对象

var parameter = new DynamicParameters();
            parameter.Add("@Id", con.Id, dbType: DbType.Int32, direction: ParameterDirection.InputOutput);
            parameter.Add("@FirstName", con.FirstName);
            parameter.Add("@LastName", con.LastName);
            parameter.Add("@Company", con.Company);
            parameter.Add("@Title", con.Title);
            parameter.Add("@Email", con.Email);

第三步：用db.Execute（）调用存储过程

db.Execute("SaveContact",parameter,commandType:CommandType.StoredProcedure);  
  
//To get newly created ID back  
con.Id = parameter.Get<int>("@Id");  

这些是使用c#动态对象操做数据库的方法。

原文连接：https://www.c-sharpcorner.com/UploadFile/e4e3f7/dapper-king-of-micro-orm-C-Sharp-net/?