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
  • WPF 已知問題 監聽 WMI 事件導致觸摸失效
    示例項目結構 在 Visual Studio 中創建一個 WinForms 應用程式後，項目結構如下所示： MyWinFormsApp/ │ ├───Properties/ │ └───Settings.settings │ ├───bin/ │ ├───Debug/ │ └───Release/ ...
  • [STAThread]特性
    [STAThread] 特性用於需要與 COM 組件交互的應用程式，尤其是依賴單線程模型（如 Windows Forms 應用程式）的組件。在 STA 模式下，線程擁有自己的消息迴圈，這對於處理用戶界面和某些 COM 組件是必要的。 [STAThread] static void Main(stri ...
  • UWP WinUI3 傳入 AddHandler 的 RoutedEventHandler 類型與事件所需不匹配將拋出參數異常
    在WinForm中使用全局異常捕獲處理 在WinForm應用程式中，全局異常捕獲是確保程式穩定性的關鍵。通過在Program類的Main方法中設置全局異常處理，可以有效地捕獲並處理未預見的異常，從而避免程式崩潰。 註冊全局異常事件 [STAThread] static void Main() { / ...
  • .NET 多版本 WinForm 開源控制項庫 SunnyUI
    前言 給大家推薦一款開源的 Winform 控制項庫，可以幫助我們開發更加美觀、漂亮的 WinForm 界面。 項目介紹 SunnyUI.NET 是一個基於 .NET Framework 4.0+、.NET 6、.NET 7 和 .NET 8 的 WinForm 開源控制項庫，同時也提供了工具類庫、擴展 ...
  • .net core8 使用Swagger（附當前源碼）
    說明 該文章是屬於OverallAuth2.0系列文章，每周更新一篇該系列文章（從0到1完成系統開發）。 該系統文章，我會儘量說的非常詳細，做到不管新手、老手都能看懂。 說明：OverallAuth2.0 是一個簡單、易懂、功能強大的許可權+可視化流程管理系統。 有興趣的朋友，請關註我吧(*^▽^*) ...
  • WPF 什麼時候 VisualTreeHelper.GetDescendantBounds 將返回無窮大
    一、下載安裝 1.下載git 必須先下載並安裝git，再TortoiseGit下載安裝 git安裝參考教程：https://blog.csdn.net/mukes/article/details/115693833 2.TortoiseGit下載與安裝 TortoiseGit，Git客戶端，32/6 ...
  • C# 開源教程帶你輕鬆掌握數據結構與演算法
    前言 在項目開發過程中，理解數據結構和演算法如同掌握蓋房子的秘訣。演算法不僅能幫助我們編寫高效、優質的代碼，還能解決項目中遇到的各種難題。 給大家推薦一個支持C#的開源免費、新手友好的數據結構與演算法入門教程：Hello演算法。 項目介紹 《Hello Algo》是一本開源免費、新手友好的數據結構與演算法入門 ...
  • 第22篇 生成proto文件bat腳本
    1.生成單個Proto.bat內容 @rem Copyright 2016, Google Inc. @rem All rights reserved. @rem @rem Redistribution and use in source and binary forms, with or with ...
  • 記一次 .NET某上位機視覺程式 卡死分析
    一：背景 1. 講故事 前段時間有位朋友找到我，說他的窗體程式在客戶這邊出現了卡死，讓我幫忙看下怎麼回事？dump也生成了，既然有dump了那就上 windbg 分析吧。 二：WinDbg 分析 1. 為什麼會卡死 窗體程式的卡死，入口門檻很低，後續往下分析就不一定了，不管怎麼說先用 !clrsta ...
  • 醫學DICOM文件與PACS系統進行數據傳輸
    前言 人工智慧時代，人臉識別技術已成為安全驗證、身份識別和用戶交互的關鍵工具。 給大家推薦一款.NET 開源提供了強大的人臉識別 API，工具不僅易於集成，還具備高效處理能力。 本文將介紹一款如何利用這些API，為我們的項目添加智能識別的亮點。 項目介紹 GitHub 上擁有 1.2k 星標的 C# ...
所有分類