一、摘要

1.1、為什麼叫本次的分享課叫《修煉手冊》？

阿笨希望本次的分享課中涉及覆蓋的一些小技巧、小技能給您帶來一些幫助。希望您在日後工作中把它作為一本實際技能手冊進行儲備，以備不時之需，一旦當手頭遇到與Dapper修煉手冊中相似用法的地方和場景，可以直接拿來進行翻閱並靈活的運用到項目中。最後阿笨建議您可以根據自己在工作中碰到的不同的使用場景，不斷的完善此本修煉手冊。

廢話不多說，直接上乾貨，我們不生產乾貨，我們只是乾貨的搬運工。

四、涉及覆蓋的知識點

1、C# Linq To Xml技術。

2、Transact-SQL修煉手冊。比如如何使用臨時表、創建用戶自定義表（TABLE）、XML數據欄位、ROW_NUMBER分頁函數、存儲過程修煉手冊（動態執行SQL、異常處理機制、事務處理機制）、C#如何獲取存儲過程的OUTPUT、RETURN參數值。

3、SQL Sever FOR XML技術（XML PATH、XML RAW、XML AUTO簡單用法介紹）。

4、Transact-SQL關鍵字OPENXML操作記憶體中的 XML 文檔。

5、Faker.Net仿照測試數據框架運用。

6、VS單元測試NuitTest運用。

7、Dapper在非同步編程(Asyn Task)中的運用。

8、原生Dapper簡單的CRUD(增刪改查) 修煉手冊。（強烈推薦）

9、Dapper如何通過DynamicParameters動態拼接查詢SQL修煉手冊。（強烈推薦）

10、Dapper擴展庫Dapper.SqlBuilder、UniqueNamespace.SqlBuilder修煉手冊。（強烈推薦）

11、原生Dapper高級技巧修煉手冊。（強烈推薦）

12、Dapper擴展庫Dapper-Extensions修煉手冊。（強烈推薦）

五、Dapper修煉手冊線上學習和演示

5.1、原生Dapper簡單的CRUD(增刪改查) 修煉手冊

Insert、Insert_Batch(批量插入數據)。

Update、Delete、Exist。

GetById、GetList、GetByIds(in子句使用)。

GetListReturnDynamic(返回dynamic)。

GetListByMultiQuery（返回多結果集Tuple）。

ExecuteWithDBTransaction（本地DbTransaction事務操作）。

ExecuteWithTransactionScope（分散式TransactionScope事務操作）。

5.2、Dapper如何通過DynamicParameters動態拼接查詢SQL修煉手冊

Insert、GetListByGenreIdAndName領略DynamicParameters的風采。

SearchOrdersByPageDynamicParametersSqlBuild:獲取分頁數據(通過DynamicParameters動態拼接查詢SQL方式拼接+ ROW_NUMBER() OVER 子句分頁)。

SearchOrdersByDynamicParametersOutPutANDReturnVaule:如何使用DynamicParameters構造和獲取存儲過程OUTPUT、RETURN參數值，以及獲取存儲過程返回一個或多個結果集。

5.3、Dapper擴展庫Dapper.SqlBuilder修煉手冊

通過SqlBuilder構造CRUD語句模板。

通過SqlBuilder內置的模板構造SELECT（查詢）、Page（分頁）語句模板。

GetOrderOneToManyByDapperSqlBuilder:獲取訂單"一對多"通過SQL語法 XML PATH子句。

SearchOrdersByPageDapperSqlBuilder:獲取分頁數據(通過Dapper.SqlBuilder拼接+ ROW_NUMBER() OVER 子句分頁)。

SearchOrdersByDapperDapperSqlBuilderSqlPagingTemplates獲取分頁數據(通過Dapper.SqlBuilder內置提供的分頁模板進行分頁)。

5.4、原生Dapper高級技巧修煉手冊

CreateOrder:創建訂單（採用sql拼接+for迴圈方式）。

CreateOrderByStoredProcedures_XMLPath:創建訂單(採用生成XML+SQL XML數據類型的XMLPath方式)。

CreateOrderByStoredProcedures_OpenXml:創建訂單(採用生成XML+SQL XML數據類型的OpenXml方式)。

CreateOrderByStoredProcedures_CustomTableType:創建訂單（採用SQL用戶創建自定義表類型）。

GetOrderOneToManyBySqlBuilder:獲取訂單（一對多）通過主從表SQL語句方式。

GetOrderOneToManyByDapperQuery:獲取訂單（一對多）通過原生Dapper Query+splitOn關鍵字。

SearchOrdersByPageSqlBuild:獲取分頁數據(通過SQL語句拼接+ ROW_NUMBER() OVER 子句分頁)。

SearchOrdersByPageSqlStoredProcedures:獲取分頁數據(通過SQL分頁存儲過程+ ROW_NUMBER() OVER 子句分頁)。

5.5、Dapper擴展庫Dapper-Extensions修煉手冊

1、Insert、Insert_Batch（批量插入數據）。

2、Update、Delete、Exist。

3、Insert_BatchBySqlBulkCopy（基於SqlBulkCopy方法進行批量插入數據）。

4、GetList:包含如下知識點:

*根據條件進行查詢（帶過濾條件和排序欄位）。

*根據多組合條件進行查詢（通過IPredicate的Predicates.Group()生成過濾條件+排序欄位）。

*根據多組合條件進行查詢（通過IPredicate.Add()生成過濾條件+排序欄位）。

*根據多組合條件進行查詢（通過Predicate多條件複合謂片語合生成過濾條件+排序欄位,示例SQL語句:Select * From Table Where(id1=@id1 AND name2=@name2) OR (id2=@id2 AND name2=@name2)。

*根據單條件進行子查詢查詢（通過IPredicate.EXISTS()子查詢過濾條件語句+排序欄位，示例語句:Select * Form Table Where       Exists(Select 1 From Table Where id=@id)）。

*根據多組合條件進行子查詢查詢（通過IPredicate.EXISTS()子查詢過濾條件語句+排序欄位,示例語句:Select * From Table Where Exists(Select Count(1) From Table Where(id1=@id1 AND name2=@name2) OR (id2=@id2 AND name2=@name2))）。

*SearchOrdersByPageDapperExtensions:獲取分頁數據(通過提供的擴展DapperExtensions多條件組合複合謂詞IPredicate+內置的Count、Page函數)。

六、小結

在ADO.NET的世界里“海闊憑魚躍，天高任鳥飛”。

Transact-SQL編程能力再上一個臺階。

領略到了Dapper她的“美”！

學完此本修煉手冊後，您將會汲取到滿滿的乾貨，讓您更加的有底氣！

後續計劃:阿笨將後續計劃給大家帶來另外一堂分享課《.NET輕量級ORM組件Dapper實戰寶典》，大概包含Dapper For MSQL,Dapper For Mysql、Dapper For Oracle、數據訪問層之Repository模式以及基於Dapper開源的倉儲模式項目運用，等等。