• 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+"
    ");
                }
                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/?

  • 相关阅读:
    关于http协议详解
    python记录_day15 面向对象初识
    python记录_day14 内置函数二 迭代 二分法
    python记录_day13 内置函数
    python记录_day12 生成器
    python记录_day11 闭包 迭代器
    函数默认参数的初始化问题
    python记录_day10 动态传参 命名空间 作用域
    python记录_day09 初识函数
    python记录_day08
  • 原文地址:https://www.cnblogs.com/itjeff/p/11512092.html
Copyright © 2020-2023  润新知