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的命名空间。


示例1:

获取所有数据并打印到控制台

第一步:创建IDbConnection类的对象和SqlConnection的新实例。

staticIDbConnection db =newSqlConnection(ConfigurationManager.ConnectionStrings["SqlServerConnString"].ConnectionString);

SqlServerConnString是连接字符串名称,可以配置在程序中的App.config中。

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

String query ="select * from contacts";

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

(List)db.Query(query)

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

对于这个示例,我们将其打印到控制台

List lstContact= (List)db.Query(query);

            foreach(varitemin lstContact)

            {

                Console.WriteLine(item.FirstName +""+ item.LastName+"\n");

            }

            Console.ReadKey();

结果:

示例2:

给Contacts表中插入数据,同样包含三步

 第一步:创建IDbConnection类的对象和SqlConnection的新实例。

staticIDbConnection db =newSqlConnection(ConfigurationManager.ConnectionStrings["SqlServerConnString"].ConnectionString);

第二步:

stringquery =@"Insert into contacts values (@FirstName, @LastName, @Email, @Company, @Title); 

Select Cast (Scope_Identity() as int)";

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

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

intid = db.Query(query, contact).Single();

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

Contact contact =newContact() { FirstName ="yixuan", LastName ="han", Email ="yixuanhan@aaa.com", Company ="BAT", Title ="PE" };

            stringquery =@"Insert into contacts values (@FirstName, @LastName, @Email, @Company, @Title); 

Select Cast (Scope_Identity() as int)";

            intid = db.Query(query, contact).Single();

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

示例3:现在,让我们通过在where子句中传递一个id,从Contacts表中获取一条记录

 第一步:创建IDbConnection类的对象和SqlConnection的新实例。

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

第二步:

stringquery ="select * from contacts where id = @id";

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

Contact cont = (Contact)db.Query(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表中获取多条数据

第一步和之前所有示例的第一步相同,我们从第二步开始

第二步:

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

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

using(varmultipleresult = db.QueryMultiple(query,new{ id =1 }))

            {

                varcontact = multipleresult.Read().SingleOrDefault();

                varAddresses = multipleresult.Read().ToList();

                if(contact !=null&& Addresses !=null)

                {

                    contact.Addresses.AddRange(Addresses);

                }

            }

以上三步你将 可以从多个表中获得多条记录

示例5:

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

我有一个存储过程,声明一个参数(ID),并且基于ID返回Contact数据和Address数据

Use ContactDB

SETANSI_NULLSONGOSETQUOTED_IDENTIFIERONGOCREATEPROCEDURE[dbo].[sp_GetContact_Address]@IdintASBEGINselect*fromcontactswhereid=@Id ;  select*fromAddresswhereContactId=@Id; ENDGO

用Dapper调用存储过程

第一步同其他示例

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

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

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

using(varmultipleresult = db.QueryMultiple("sp_GetContact_Address",new{ id =1 }, commandType: CommandType.StoredProcedure))

            {

                varcontact = multipleresult.Read().SingleOrDefault();

                varAddresses = multipleresult.Read().ToList();

                if(contact !=null&& Addresses !=null)

                {

                    contact.Addresses.AddRange(Addresses);

                }

            }

仅仅两步,就 可以成功的调用数据库中的存储过程

示例6:

当我们需要处理运行时对象时,还可以将动态对象或者值传递给存储过程

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

use ContactDBSETANSI_NULLSONGOSETQUOTED_IDENTIFIERONGOCREATEPROCEDURE[dbo].[SaveContact]@Idint output,

    @FirstNamenvarchar(50),

    @LastNamenvarchar(50),

    @Emailnvarchar(50),

    @Companynvarchar(50),

    @Titlenvarchar(50)ASBEGININSERTINTO[dbo].[Contacts] 

          ([FirstName],[LastName],[Company],[Title],[Email])VALUES 

          (@FirstName,@LastName,@Company,@Title,@Email); 

        SET@Id=cast(scope_identity()asint)  ENDGO

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

第一步同其他示例

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

varparameter =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("@Id");

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

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

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 195,980评论 5 462
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 82,422评论 2 373
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 143,130评论 0 325
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 52,553评论 1 267
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 61,408评论 5 358
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 46,326评论 1 273
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 36,720评论 3 386
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 35,373评论 0 254
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 39,678评论 1 294
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,722评论 2 312
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,486评论 1 326
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,335评论 3 313
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 37,738评论 3 299
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,009评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,283评论 1 251
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 41,692评论 2 342
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 40,893评论 2 335

推荐阅读更多精彩内容

  • 关于Mongodb的全面总结 MongoDB的内部构造《MongoDB The Definitive Guide》...
    中v中阅读 31,864评论 2 89
  • 概述在iOS开发中UITableView可以说是使用最广泛的控件,我们平时使用的软件中到处都可以看到它的影子,类似...
    liudhkk阅读 8,914评论 3 38
  • 应用程序还需要操作存储在其他数据源(如SQL数据库或XML文件)中的数据,甚至通过Web服务访问它们。传统上,查询...
    CarlDonitz阅读 580评论 0 0
  • pandas dataFrame(数据框)是能够有效表示csv文件内容的一种数据格式,它是允许每一列属于不同类型的...
    谁共我醉明月阅读 123评论 0 1
  • 最近打算系统学习广论,但进度总是被琐事打断,网上买来二十册的全套书,装模作样,第一本还没看完。在这样散漫的状态下,...
    Evangelinehu阅读 192评论 0 0