C# 數據操作系列 - 17 Dapper ——號稱可以與ADO.NET 同台飆車的ORM

来源:https://www.cnblogs.com/c7jie/archive/2020/05/27/12971352.html
-Advertisement-
Play Games

0. 前言 之前四篇介紹了一個國內開發者開發的優秀框架SqlSugar，給我們眼前一亮的感覺。這一篇，我們將試試另一個出鏡率比較高的ORM框架-Dapper。 Dapper是一個輕量級的ORM框架，其以高速、簡單易用為特點。在某些時候，效率甚至可以與ADO.NET 媲美。那麼，吹得天花亂墜，就讓我們 ...


0. 前言

之前四篇介紹了一個國內開發者開發的優秀框架SqlSugar，給我們眼前一亮的感覺。這一篇，我們將試試另一個出鏡率比較高的ORM框架-Dapper。

Dapper是一個輕量級的ORM框架，其以高速、簡單易用為特點。在某些時候，效率甚至可以與ADO.NET 媲美。那麼，吹得天花亂墜，就讓我們實際看看它的表現吧。

1. 開始使用

照例，先創建一個項目：DapperDemo

dotnet new console --name DapperDemo

然後切換到目錄里：

cd DapperDemo

添加包支持：

dotnet add package Dapper

如果不出意外的話，目前項目中已經安裝好了Dapper。現在就讓我們開始愉快的使用吧。

首先，需要註意的一點是，與其他的ORM框架不同的是，Dapper需要我們手動創建一個IConnection。Dapper的所有操作都是依托於IConnection來操作，而且Dapper將其支持的方法封裝成了IConnection的擴展方法。

所以，在使用之前我們需要先創建一個IConnection。為了方便演示，我把之前SqlSugar演示用過的測試資料庫拿過來了，是一個SQLite，所以我們需要先安裝一個SQLite的驅動：

dotnet add package Microsoft.Data.SQLite

在Program.cs中引入兩個包：

using Microsoft.Data.Sqlite;
using Dapper;

在Main方法里創建一個IConnection：

using(var connection = new SqliteConnection("Data Source=./demo.db"))
{
    
}

2. 多數據查詢

Dapper的查詢相當簡單：

var result = connection.Query("select * from Persion");

傳入一個SQL語句，返回一個可枚舉對象。如果不指定類型，將返回類型為dynamic的列表。我們來看一下Query方法的相關聲明：

public static IEnumerable<dynamic> Query(this IDbConnection cnn, string sql, object param = null, IDbTransaction transaction = null, bool buffered = true, int? commandTimeout = null, CommandType? commandType = null);

public static IEnumerable<T> Query<T>(this IDbConnection cnn, string sql, object param = null, IDbTransaction transaction = null, bool buffered = true, int? commandTimeout = null, CommandType? commandType = null);

public static IEnumerable<TReturn> Query<TReturn>(this IDbConnection cnn, string sql, Type[] types, Func<object[], TReturn> map, object param = null, IDbTransaction transaction = null, bool buffered = true, string splitOn = "Id", int? commandTimeout = null, CommandType? commandType = null);

我們就以最常用的三個為例，給大伙分析一下參數以及調用方式：

  • cnn 一個資料庫連接，所以Dapper不負責管理資料庫連接，這部分由我們手動管理
  • sql 傳入的SQL語句，Dapper以IDbConnection為基礎，以SQL為執行命令，所以必須我們來傳入SQL語句
  • param 一個可以為Null的Object類型，表示SQL的參數化，Dapper對參數化做了一些優化，在SQL的參數化里，參數名映射到了object的屬性上。
  • transaction 表示是否有IConnection級別的事務，預設為null，傳入後該指令會被事務包含
  • buffered 緩存
  • commandTimeout 命令執行是否超時以及超時時間
  • commandType 表示命令模式 有 Text 普通模式，StoredProcedure 存儲過程 ，TableDirect 表查詢
  • splitOn 預設情況下以Id 作為兩個對象之間的區分

3. 單數據查詢

Dapper在數據查詢方面不僅支持集合作為查詢結果，還可以獲取單個數據。

一共有四種方式獲取單數據：

public static T QueryFirst<T>(this IDbConnection cnn, string sql, object param = null, IDbTransaction transaction = null, int? commandTimeout = null, CommandType? commandType = null);
public static T QueryFirstOrDefault<T>(this IDbConnection cnn, string sql, object param = null, IDbTransaction transaction = null, int? commandTimeout = null, CommandType? commandType = null);

QueryFirst 表示獲取第一條查詢結果，如果沒有結果，則會拋出一個異常。

QueryFirstOrDefault 與QueryFirst一樣，但不同的是，如果沒有則不會拋出異常，而是直接返回一個該類型的預設值，數值類型的預設值為(0)，引用類型的預設值為Null。

public static T QuerySingle<T>(this IDbConnection cnn, string sql, object param = null, IDbTransaction transaction = null, int? commandTimeout = null, CommandType? commandType = null);
public static T QuerySingleOrDefault<T>(this IDbConnection cnn, string sql, object param = null, IDbTransaction transaction = null, int? commandTimeout = null, CommandType? commandType = null);

QuerySingle也能查詢單條數據作為結果，但與QueryFirst不同的是QuerySingle查詢時，如果數據存在多行將會拋出異常，如果不想要異常則可以使用QuerySingleOrDefault作為查詢方法。

4. QueryMultiple

這個另外一種查詢方式，對於SQL語句來說，沒有明顯的限制，所以我們有時候可以傳入多個查詢SQL語句進去，然後分別獲取來自各個表的查詢數據：

string sql = "SELECT * FROM Invoice WHERE InvoiceID = @InvoiceID; SELECT * FROM InvoiceItem WHERE InvoiceID = @InvoiceID;";

using (var connection = My.ConnectionFactory())
{
    connection.Open();

    using (var multi = connection.QueryMultiple(sql, new {InvoiceID = 1}))
    {
        var invoice = multi.Read<Invoice>().First();
        var invoiceItems = multi.Read<InvoiceItem>().ToList();
    }
}

看一下它的基本參數和方法聲明：

public static GridReader QueryMultiple(this IDbConnection cnn, string sql, object param = null, IDbTransaction transaction = null, int? commandTimeout = null, CommandType? commandType = null);

這個方法返回一個GridReader，通過Read方法獲取需要的數據。

5. 不只是查詢

Dapper當然不只有查詢這一項功能，Dapper支持使用存儲過程、insert、update、delete等其他的SQL語句進行操作資料庫。使用方式：

string sql = "Invoice_Insert";

using (var connection = My.ConnectionFactory())
{
    var affectedRows = connection.Execute(sql,
        new {Kind = InvoiceKind.WebInvoice, Code = "Single_Insert_1"},
        commandType: CommandType.StoredProcedure);
    var affectedRows2 = connection.Execute(sql,
        new[]
        {
            new {Kind = InvoiceKind.WebInvoice, Code = "Many_Insert_1"},
            new {Kind = InvoiceKind.WebInvoice, Code = "Many_Insert_2"},
            new {Kind = InvoiceKind.StoreInvoice, Code = "Many_Insert_3"}
        },
        commandType: CommandType.StoredProcedure
    );
}

示例就是使用存儲過程的例子。

string sql = "INSERT INTO Customers (CustomerName) Values (@CustomerName);";

using (var connection = new SqlConnection(FiddleHelper.GetConnectionStringSqlServerW3Schools()))
{
    var affectedRows = connection.Execute(sql, new {CustomerName = "Mark"});

    Console.WriteLine(affectedRows);

    var customer = connection.Query<Customer>("Select * FROM CUSTOMERS WHERE CustomerName = 'Mark'").ToList();

    FiddleHelper.WriteTable(customer);
}
//== 多次插入
string sql = "INSERT INTO Customers (CustomerName) Values (@CustomerName);";

using (var connection = new SqlConnection(FiddleHelper.GetConnectionStringSqlServerW3Schools()))
{
    connection.Open();

    var affectedRows = connection.Execute(sql,
    new[]
    {
    new {CustomerName = "John"},
    new {CustomerName = "Andy"},
    new {CustomerName = "Allan"}
    }
);

這是執行插入的示例。

string sql = "UPDATE Categories SET Description = @Description WHERE CategoryID = @CategoryID;";

using (var connection = new SqlConnection(FiddleHelper.GetConnectionStringSqlServerW3Schools()))
{            
    var affectedRows = connection.Execute(sql,new {CategoryID = 1, Description = "Soft drinks, coffees, teas, beers, mixed drinks, and ales"});

    Console.WriteLine(affectedRows);
}

更新。

string sql = "DELETE FROM Customers WHERE CustomerID = @CustomerID";

using (var connection = new SqlConnection(FiddleHelper.GetConnectionStringSqlServerW3Schools()))
{            
    var affectedRows = connection.Execute(sql, new {CustomerID = 1});

    Console.WriteLine(affectedRows);
}

刪除。

Execute沒什麼好說的，基本就是執行SQL語句的形式完成增刪改成等操作。

值得註意的是：

public static IDataReader ExecuteReader(this IDbConnection cnn, string sql, object param = null, IDbTransaction transaction = null, int? commandTimeout = null, CommandType? commandType = null);

返回一個IDataReader實例，這個實例可以給DataTable填充數據，使用方法如下：

DataTable table = new DataTable();
table.Load(reader);

以及：

public static T ExecuteScalar<T>(this IDbConnection cnn, string sql, object param = null, IDbTransaction transaction = null, int? commandTimeout = null, CommandType? commandType = null);

這個方法是返回查詢結果的第一行第一列的元素。

6. 總結

如果單說Dapper的話，並沒有太多好說的。不過Dapper是真的快，在實際開發中有時候會用Dapper作為EF Core的一個補充。

當然了，Dapper還有很多其他的插件，使用那些插件可以為Dappe帶來非一般的提升。我們下一篇將介紹一下Dapper的插件。

更多內容煩請關註我的博客《高先生小屋》

file


您的分享是我們最大的動力!

-Advertisement-
Play Games
更多相關文章
  • Python基礎-11函數
    11.函數 函數在Python占有非常重要的地位，可以實現代碼復用，增強代碼可讀性等等。在Python在函數通常被分為常規函數、匿名函數和高階函數。 11.1常規函數 在Python定義一個函數使用def關鍵字，其格式如下所示： def functionName(para1,para2,...,pa ...
  • 從入門角度深入理解——有關最短路的常見演算法
    解最短路的必要基礎（BFS與DFS，STL，如何存圖）DFS與BFS問題引入DFS深度優先搜索(Depth First Search)：解析：過程：BFSBFS引入BFS遍歷樹的過程講解對於圖上的BFS小結DFS與BFS問題引入 有一天，你穿越到Clannad（炒雞好看的游戲與番劇）的小鎮。你知道小 ...
  • 【視頻】工業互聯網線上交流現狀、發展、怎麼建和規劃
    PPT介紹目錄： 工業互聯網的現狀 平臺介紹 技術路線 人力資源 現實問題 成本中心 工業互聯網的發展 兩大推動引擎 用戶需求的改變 片面與極端 由點到面，點面結合 突破點 現實路徑 落腳點 工業互聯網怎麼建 一句話表示-方法論 怎麼成功 體系理念 工業互聯網未來的規劃 iNeuOS介紹 文章： 《 ...
  • ispostback之坑
    IsPostBack:獲取一個值，該值指示頁是第一次呈現還是為了響應回發而載入。 一般的話如果第一次請求是get的話，那麼IsPostBack會為false，如果接下來post請求，則為true；這樣可以區分第一次和其他按鈕請求的情況。 但今天使用jQuery在主頁面的一個超鏈接post調用子頁面的 ...
  • .Net 提交頁面，js修改的Label值會丟掉
    .Net 提交頁面，js修改的Label值會丟掉 版權聲明：本文為博主原創文章，遵循 CC 4.0 BY-SA 版權協議，轉載請附上原文出處鏈接和本聲明。 本文鏈接：https://blog.csdn.net/chenghaibing2008/article/details/9011043 當用js ...
  • C#實現密文解密
    C#實現密文解密 簡介：此方法一般用於對密碼加密後的解密。 代碼： private static string GetPwd(string pwd) { var sRet = string.Empty; for (int i = 0; i < pwd.Length; i++) { sRet = sR ...
  • EF Core 執行SQL語句和存儲過程
    無論ORM有多麼強大，總會出現一些特殊的情況，它無法滿足我們的要求。在這篇文章中，我們介紹幾種執行SQL的方法。 表結構 在具體內容開始之前，我們先簡單說明一下要使用的表結構。 public class Category { public int CategoryID { get; set; } p ...
  • 【半譯】擴展shutdown超時設置以保證IHostedService正常關閉
    我最近發現一個問題，當應用程式關閉時，我們的應用程式沒有正確執行在IHostedService中的StopAsync方法。經過反覆驗證發現，這是由於某些服務對關閉信號做出響應所需的時間太長導致的。在這篇文章中，我將展示出現這個問題的一個示例，並且會討論它為什麼會發生以及如何避免這種情況出現。 作者： ...
一周排行
    -Advertisement-
    Play Games
  • 移動開發（一）：使用.NET MAUI開發第一個安卓APP
    移動開發（一）：使用.NET MAUI開發第一個安卓APP 對於工作多年的C#程式員來說，近來想嘗試開發一款安卓APP，考慮了很久最終選擇使用.NET MAUI這個微軟官方的框架來嘗試體驗開發安卓APP，畢竟是使用Visual Studio開發工具，使用起來也比較的順手，結合微軟官方的教程進行了安卓 ...
  • wpf ToggleButton選中效果和一個登錄界面
    前言 QuestPDF 是一個開源 .NET 庫，用於生成 PDF 文檔。使用了C# Fluent API方式可簡化開發、減少錯誤並提高工作效率。利用它可以輕鬆生成 PDF 報告、發票、導出文件等。 項目介紹 QuestPDF 是一個革命性的開源 .NET 庫，它徹底改變了我們生成 PDF 文檔的方 ...
  • 彈幕樹洞項目功能新增篇
    項目地址 項目後端地址： https://github.com/ZyPLJ/ZYTteeHole 項目前端頁面地址： ZyPLJ/TreeHoleVue (github.com) https://github.com/ZyPLJ/TreeHoleVue 目前項目測試訪問地址： http://tree ...
  • 第27篇 sqlserver2022詳細安裝步驟
    話不多說，直接開乾 一.下載 1.官方鏈接下載： https://www.microsoft.com/zh-cn/sql-server/sql-server-downloads 2.在下載目錄中找到下麵這個小的安裝包 SQL2022-SSEI-Dev.exe，運行開始下載SQL server； 二. ...
  • .NET 開源高性能 MQTT 類庫
    前言 隨著物聯網（IoT）技術的迅猛發展，MQTT（消息隊列遙測傳輸）協議憑藉其輕量級和高效性，已成為眾多物聯網應用的首選通信標準。 MQTTnet 作為一個高性能的 .NET 開源庫，為 .NET 平臺上的 MQTT 客戶端與伺服器開發提供了強大的支持。 本文將全面介紹 MQTTnet 的核心功能 ...
  • Serilog文檔翻譯系列（六） - 可用的接收器、增強器、格式化輸出
    Serilog支持多種接收器用於日誌存儲，增強器用於添加屬性，LogContext管理動態屬性，支持多種輸出格式包括純文本、JSON及ExpressionTemplate。還提供了自定義格式化選項，適用於不同需求。 ...
  • 警惕 Visual Studio 屬性求值副作用導致邏輯不符合預期
    目錄簡介獲取 HTML 文檔解析 HTML 文檔測試參考文章 簡介 動態內容網站使用 JavaScript 腳本動態檢索和渲染數據，爬取信息時需要模擬瀏覽器行為，否則獲取到的源碼基本是空的。 本文使用的爬取步驟如下： 使用 Selenium 獲取渲染後的 HTML 文檔 使用 HtmlAgility ...
  • [使用目前最新版]HybridCLR6.9.0+YooAsset2.2.4實現純C# Unity熱更新方案 (一)
    1.前言 什麼是熱更新 游戲或者軟體更新時，無需重新下載客戶端進行安裝，而是在應用程式啟動的情況下，在內部進行資源或者代碼更新 Unity目前常用熱更新解決方案 HybridCLR，Xlua，ILRuntime等 Unity目前常用資源管理解決方案 AssetBundles，Addressable， ...
  • 在 ASP.NET Core Web API 中使用操作篩選器統一處理通用操作
    本文章主要是在C# ASP.NET Core Web API框架實現向手機發送驗證碼簡訊功能。這裡我選擇是一個互億無線簡訊驗證碼平臺，其實像阿裡雲，騰訊雲上面也可以。 首先我們先去 互億無線 https://www.ihuyi.com/api/sms.html 去註冊一個賬號 註冊完成賬號後，它會送 ...
  • 第28篇 如何.net中實現高效可靠數據同步api
    通過以下方式可以高效，並保證數據同步的可靠性 1.API設計 使用RESTful設計，確保API端點明確，並使用適當的HTTP方法（如POST用於創建，PUT用於更新）。 設計清晰的請求和響應模型，以確保客戶端能夠理解預期格式。 2.數據驗證 在伺服器端進行嚴格的數據驗證，確保接收到的數據符合預期格 ...
所有分類