/Dapper/SqlMapper.Async.cs

http://github.com/SamSaffron/dapper-dot-net · C# · 1233 lines · 543 code · 80 blank · 610 comment · 88 complexity · 1a6a5f7a54b7ebf4862c0b2d84fa5f01 MD5 · raw file

Large files are truncated click here to view the full file

    

  1. using System;

    2. 

  2. using System.Collections;

    3. 

  3. using System.Collections.Generic;

    4. 

  4. using System.Data;

    5. 

  5. using System.Data.Common;

    6. 

  6. using System.Globalization;

    7. 

  7. using System.Linq;

    8. 

  8. using System.Threading;

    9. 

  9. using System.Threading.Tasks;

    10. 

  10. 

    11. 

  11. namespace Dapper

    12. 

  12. {

    13. 

  13.     public static partial class SqlMapper

    14. 

  14.     {

    15. 

  15.         /// <summary>

    16. 

  16.         /// Execute a query asynchronously using Task.

    17. 

  17.         /// </summary>

    18. 

  18.         /// <param name="cnn">The connection to query on.</param>

    19. 

  19.         /// <param name="sql">The SQL to execute for the query.</param>

    20. 

  20.         /// <param name="param">The parameters to pass, if any.</param>

    21. 

  21.         /// <param name="transaction">The transaction to use, if any.</param>

    22. 

  22.         /// <param name="commandTimeout">The command timeout (in seconds).</param>

    23. 

  23.         /// <param name="commandType">The type of command to execute.</param>

    24. 

  24.         /// <remarks>Note: each row can be accessed via "dynamic", or by casting to an IDictionary&lt;string,object&gt;</remarks>

    25. 

  25.         public static Task<IEnumerable<dynamic>> QueryAsync(this IDbConnection cnn, string sql, object param = null, IDbTransaction transaction = null, int? commandTimeout = null, CommandType? commandType = null) =>

    26. 

  26.             QueryAsync<dynamic>(cnn, typeof(DapperRow), new CommandDefinition(sql, param, transaction, commandTimeout, commandType, CommandFlags.Buffered, default(CancellationToken)));

    27. 

  27. 

    28. 

  28.         /// <summary>

    29. 

  29.         /// Execute a query asynchronously using Task.

    30. 

  30.         /// </summary>

    31. 

  31.         /// <param name="cnn">The connection to query on.</param>

    32. 

  32.         /// <param name="command">The command used to query on this connection.</param>

    33. 

  33.         /// <remarks>Note: each row can be accessed via "dynamic", or by casting to an IDictionary&lt;string,object&gt;</remarks>

    34. 

  34.         public static Task<IEnumerable<dynamic>> QueryAsync(this IDbConnection cnn, CommandDefinition command) =>

    35. 

  35.             QueryAsync<dynamic>(cnn, typeof(DapperRow), command);

    36. 

  36. 

    37. 

  37.         /// <summary>

    38. 

  38.         /// Execute a single-row query asynchronously using Task.

    39. 

  39.         /// </summary>

    40. 

  40.         /// <param name="cnn">The connection to query on.</param>

    41. 

  41.         /// <param name="command">The command used to query on this connection.</param>

    42. 

  42.         /// <remarks>Note: the row can be accessed via "dynamic", or by casting to an IDictionary&lt;string,object&gt;</remarks>

    43. 

  43.         public static Task<dynamic> QueryFirstAsync(this IDbConnection cnn, CommandDefinition command) =>

    44. 

  44.             QueryRowAsync<dynamic>(cnn, Row.First, typeof(DapperRow), command);

    45. 

  45. 

    46. 

  46.         /// <summary>

    47. 

  47.         /// Execute a single-row query asynchronously using Task.

    48. 

  48.         /// </summary>

    49. 

  49.         /// <param name="cnn">The connection to query on.</param>

    50. 

  50.         /// <param name="command">The command used to query on this connection.</param>

    51. 

  51.         /// <remarks>Note: the row can be accessed via "dynamic", or by casting to an IDictionary&lt;string,object&gt;</remarks>

    52. 

  52.         public static Task<dynamic> QueryFirstOrDefaultAsync(this IDbConnection cnn, CommandDefinition command) =>

    53. 

  53.             QueryRowAsync<dynamic>(cnn, Row.FirstOrDefault, typeof(DapperRow), command);

    54. 

  54. 

    55. 

  55.         /// <summary>

    56. 

  56.         /// Execute a single-row query asynchronously using Task.

    57. 

  57.         /// </summary>

    58. 

  58.         /// <param name="cnn">The connection to query on.</param>

    59. 

  59.         /// <param name="command">The command used to query on this connection.</param>

    60. 

  60.         /// <remarks>Note: the row can be accessed via "dynamic", or by casting to an IDictionary&lt;string,object&gt;</remarks>

    61. 

  61.         public static Task<dynamic> QuerySingleAsync(this IDbConnection cnn, CommandDefinition command) =>

    62. 

  62.             QueryRowAsync<dynamic>(cnn, Row.Single, typeof(DapperRow), command);

    63. 

  63. 

    64. 

  64.         /// <summary>

    65. 

  65.         /// Execute a single-row query asynchronously using Task.

    66. 

  66.         /// </summary>

    67. 

  67.         /// <param name="cnn">The connection to query on.</param>

    68. 

  68.         /// <param name="command">The command used to query on this connection.</param>

    69. 

  69.         /// <remarks>Note: the row can be accessed via "dynamic", or by casting to an IDictionary&lt;string,object&gt;</remarks>

    70. 

  70.         public static Task<dynamic> QuerySingleOrDefaultAsync(this IDbConnection cnn, CommandDefinition command) =>

    71. 

  71.             QueryRowAsync<dynamic>(cnn, Row.SingleOrDefault, typeof(DapperRow), command);

    72. 

  72. 

    73. 

  73.         /// <summary>

    74. 

  74.         /// Execute a query asynchronously using Task.

    75. 

  75.         /// </summary>

    76. 

  76.         /// <typeparam name="T">The type of results to return.</typeparam>

    77. 

  77.         /// <param name="cnn">The connection to query on.</param>

    78. 

  78.         /// <param name="sql">The SQL to execute for the query.</param>

    79. 

  79.         /// <param name="param">The parameters to pass, if any.</param>

    80. 

  80.         /// <param name="transaction">The transaction to use, if any.</param>

    81. 

  81.         /// <param name="commandTimeout">The command timeout (in seconds).</param>

    82. 

  82.         /// <param name="commandType">The type of command to execute.</param>

    83. 

  83.         /// <returns>

    84. 

  84.         /// A sequence of data of <typeparamref name="T"/>; if a basic type (int, string, etc) is queried then the data from the first column in assumed, otherwise an instance is

    85. 

  85.         /// created per row, and a direct column-name===member-name mapping is assumed (case insensitive).

    86. 

  86.         /// </returns>

    87. 

  87.         public static Task<IEnumerable<T>> QueryAsync<T>(this IDbConnection cnn, string sql, object param = null, IDbTransaction transaction = null, int? commandTimeout = null, CommandType? commandType = null) =>

    88. 

  88.             QueryAsync<T>(cnn, typeof(T), new CommandDefinition(sql, param, transaction, commandTimeout, commandType, CommandFlags.Buffered, default(CancellationToken)));

    89. 

  89. 

    90. 

  90.         /// <summary>

    91. 

  91.         /// Execute a single-row query asynchronously using Task.

    92. 

  92.         /// </summary>

    93. 

  93.         /// <typeparam name="T">The type of result to return.</typeparam>

    94. 

  94.         /// <param name="cnn">The connection to query on.</param>

    95. 

  95.         /// <param name="sql">The SQL to execute for the query.</param>

    96. 

  96.         /// <param name="param">The parameters to pass, if any.</param>

    97. 

  97.         /// <param name="transaction">The transaction to use, if any.</param>

    98. 

  98.         /// <param name="commandTimeout">The command timeout (in seconds).</param>

    99. 

  99.         /// <param name="commandType">The type of command to execute.</param>

    100. 

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

    101. 

  101.             QueryRowAsync<T>(cnn, Row.First, typeof(T), new CommandDefinition(sql, param, transaction, commandTimeout, commandType, CommandFlags.None, default(CancellationToken)));

    102. 

  102. 

    103. 

  103.         /// <summary>

    104. 

  104.         /// Execute a single-row query asynchronously using Task.

    105. 

  105.         /// </summary>

    106. 

  106.         /// <typeparam name="T">The type of result to return.</typeparam>

    107. 

  107.         /// <param name="cnn">The connection to query on.</param>

    108. 

  108.         /// <param name="sql">The SQL to execute for the query.</param>

    109. 

  109.         /// <param name="param">The parameters to pass, if any.</param>

    110. 

  110.         /// <param name="transaction">The transaction to use, if any.</param>

    111. 

  111.         /// <param name="commandTimeout">The command timeout (in seconds).</param>

    112. 

  112.         /// <param name="commandType">The type of command to execute.</param>

    113. 

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

    114. 

  114.             QueryRowAsync<T>(cnn, Row.FirstOrDefault, typeof(T), new CommandDefinition(sql, param, transaction, commandTimeout, commandType, CommandFlags.None, default(CancellationToken)));

    115. 

  115. 

    116. 

  116.         /// <summary>

    117. 

  117.         /// Execute a single-row query asynchronously using Task.

    118. 

  118.         /// </summary>

    119. 

  119.         /// <typeparam name="T">The type of result to return.</typeparam>

    120. 

  120.         /// <param name="cnn">The connection to query on.</param>

    121. 

  121.         /// <param name="sql">The SQL to execute for the query.</param>

    122. 

  122.         /// <param name="param">The parameters to pass, if any.</param>

    123. 

  123.         /// <param name="transaction">The transaction to use, if any.</param>

    124. 

  124.         /// <param name="commandTimeout">The command timeout (in seconds).</param>

    125. 

  125.         /// <param name="commandType">The type of command to execute.</param>

    126. 

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

    127. 

  127.             QueryRowAsync<T>(cnn, Row.Single, typeof(T), new CommandDefinition(sql, param, transaction, commandTimeout, commandType, CommandFlags.None, default(CancellationToken)));

    128. 

  128. 

    129. 

  129.         /// <summary>

    130. 

  130.         /// Execute a single-row query asynchronously using Task.

    131. 

  131.         /// </summary>

    132. 

  132.         /// <typeparam name="T">The type to return.</typeparam>

    133. 

  133.         /// <param name="cnn">The connection to query on.</param>

    134. 

  134.         /// <param name="sql">The SQL to execute for the query.</param>

    135. 

  135.         /// <param name="param">The parameters to pass, if any.</param>

    136. 

  136.         /// <param name="transaction">The transaction to use, if any.</param>

    137. 

  137.         /// <param name="commandTimeout">The command timeout (in seconds).</param>

    138. 

  138.         /// <param name="commandType">The type of command to execute.</param>

    139. 

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

    140. 

  140.             QueryRowAsync<T>(cnn, Row.SingleOrDefault, typeof(T), new CommandDefinition(sql, param, transaction, commandTimeout, commandType, CommandFlags.None, default(CancellationToken)));

    141. 

  141. 

    142. 

  142.         /// <summary>

    143. 

  143.         /// Execute a single-row query asynchronously using Task.

    144. 

  144.         /// </summary>

    145. 

  145.         /// <param name="cnn">The connection to query on.</param>

    146. 

  146.         /// <param name="sql">The SQL to execute for the query.</param>

    147. 

  147.         /// <param name="param">The parameters to pass, if any.</param>

    148. 

  148.         /// <param name="transaction">The transaction to use, if any.</param>

    149. 

  149.         /// <param name="commandTimeout">The command timeout (in seconds).</param>

    150. 

  150.         /// <param name="commandType">The type of command to execute.</param>

    151. 

  151.         public static Task<dynamic> QueryFirstAsync(this IDbConnection cnn, string sql, object param = null, IDbTransaction transaction = null, int? commandTimeout = null, CommandType? commandType = null) =>

    152. 

  152.             QueryRowAsync<dynamic>(cnn, Row.First, typeof(DapperRow), new CommandDefinition(sql, param, transaction, commandTimeout, commandType, CommandFlags.None, default(CancellationToken)));

    153. 

  153. 

    154. 

  154.         /// <summary>

    155. 

  155.         /// Execute a single-row query asynchronously using Task.

    156. 

  156.         /// </summary>

    157. 

  157.         /// <param name="cnn">The connection to query on.</param>

    158. 

  158.         /// <param name="sql">The SQL to execute for the query.</param>

    159. 

  159.         /// <param name="param">The parameters to pass, if any.</param>

    160. 

  160.         /// <param name="transaction">The transaction to use, if any.</param>

    161. 

  161.         /// <param name="commandTimeout">The command timeout (in seconds).</param>

    162. 

  162.         /// <param name="commandType">The type of command to execute.</param>

    163. 

  163.         public static Task<dynamic> QueryFirstOrDefaultAsync(this IDbConnection cnn, string sql, object param = null, IDbTransaction transaction = null, int? commandTimeout = null, CommandType? commandType = null) =>

    164. 

  164.             QueryRowAsync<dynamic>(cnn, Row.FirstOrDefault, typeof(DapperRow), new CommandDefinition(sql, param, transaction, commandTimeout, commandType, CommandFlags.None, default(CancellationToken)));

    165. 

  165. 

    166. 

  166.         /// <summary>

    167. 

  167.         /// Execute a single-row query asynchronously using Task.

    168. 

  168.         /// </summary>

    169. 

  169.         /// <param name="cnn">The connection to query on.</param>

    170. 

  170.         /// <param name="sql">The SQL to execute for the query.</param>

    171. 

  171.         /// <param name="param">The parameters to pass, if any.</param>

    172. 

  172.         /// <param name="transaction">The transaction to use, if any.</param>

    173. 

  173.         /// <param name="commandTimeout">The command timeout (in seconds).</param>

    174. 

  174.         /// <param name="commandType">The type of command to execute.</param>

    175. 

  175.         public static Task<dynamic> QuerySingleAsync(this IDbConnection cnn, string sql, object param = null, IDbTransaction transaction = null, int? commandTimeout = null, CommandType? commandType = null) =>

    176. 

  176.             QueryRowAsync<dynamic>(cnn, Row.Single, typeof(DapperRow), new CommandDefinition(sql, param, transaction, commandTimeout, commandType, CommandFlags.None, default(CancellationToken)));

    177. 

  177. 

    178. 

  178.         /// <summary>

    179. 

  179.         /// Execute a single-row query asynchronously using Task.

    180. 

  180.         /// </summary>

    181. 

  181.         /// <param name="cnn">The connection to query on.</param>

    182. 

  182.         /// <param name="sql">The SQL to execute for the query.</param>

    183. 

  183.         /// <param name="param">The parameters to pass, if any.</param>

    184. 

  184.         /// <param name="transaction">The transaction to use, if any.</param>

    185. 

  185.         /// <param name="commandTimeout">The command timeout (in seconds).</param>

    186. 

  186.         /// <param name="commandType">The type of command to execute.</param>

    187. 

  187.         public static Task<dynamic> QuerySingleOrDefaultAsync(this IDbConnection cnn, string sql, object param = null, IDbTransaction transaction = null, int? commandTimeout = null, CommandType? commandType = null) =>

    188. 

  188.             QueryRowAsync<dynamic>(cnn, Row.SingleOrDefault, typeof(DapperRow), new CommandDefinition(sql, param, transaction, commandTimeout, commandType, CommandFlags.None, default(CancellationToken)));

    189. 

  189. 

    190. 

  190.         /// <summary>

    191. 

  191.         /// Execute a query asynchronously using Task.

    192. 

  192.         /// </summary>

    193. 

  193.         /// <param name="cnn">The connection to query on.</param>

    194. 

  194.         /// <param name="type">The type to return.</param>

    195. 

  195.         /// <param name="sql">The SQL to execute for the query.</param>

    196. 

  196.         /// <param name="param">The parameters to pass, if any.</param>

    197. 

  197.         /// <param name="transaction">The transaction to use, if any.</param>

    198. 

  198.         /// <param name="commandTimeout">The command timeout (in seconds).</param>

    199. 

  199.         /// <param name="commandType">The type of command to execute.</param>

    200. 

  200.         /// <exception cref="ArgumentNullException"><paramref name="type"/> is <c>null</c>.</exception>

    201. 

  201.         public static Task<IEnumerable<object>> QueryAsync(this IDbConnection cnn, Type type, string sql, object param = null, IDbTransaction transaction = null, int? commandTimeout = null, CommandType? commandType = null)

    202. 

  202.         {

    203. 

  203.             if (type == null) throw new ArgumentNullException(nameof(type));

    204. 

  204.             return QueryAsync<object>(cnn, type, new CommandDefinition(sql, param, transaction, commandTimeout, commandType, CommandFlags.Buffered, default(CancellationToken)));

    205. 

  205.         }

    206. 

  206. 

    207. 

  207.         /// <summary>

    208. 

  208.         /// Execute a single-row query asynchronously using Task.

    209. 

  209.         /// </summary>

    210. 

  210.         /// <param name="cnn">The connection to query on.</param>

    211. 

  211.         /// <param name="type">The type to return.</param>

    212. 

  212.         /// <param name="sql">The SQL to execute for the query.</param>

    213. 

  213.         /// <param name="param">The parameters to pass, if any.</param>

    214. 

  214.         /// <param name="transaction">The transaction to use, if any.</param>

    215. 

  215.         /// <param name="commandTimeout">The command timeout (in seconds).</param>

    216. 

  216.         /// <param name="commandType">The type of command to execute.</param>

    217. 

  217.         /// <exception cref="ArgumentNullException"><paramref name="type"/> is <c>null</c>.</exception>

    218. 

  218.         public static Task<object> QueryFirstAsync(this IDbConnection cnn, Type type, string sql, object param = null, IDbTransaction transaction = null, int? commandTimeout = null, CommandType? commandType = null)

    219. 

  219.         {

    220. 

  220.             if (type == null) throw new ArgumentNullException(nameof(type));

    221. 

  221.             return QueryRowAsync<object>(cnn, Row.First, type, new CommandDefinition(sql, param, transaction, commandTimeout, commandType, CommandFlags.None, default(CancellationToken)));

    222. 

  222.         }

    223. 

  223.         /// <summary>

    224. 

  224.         /// Execute a single-row query asynchronously using Task.

    225. 

  225.         /// </summary>

    226. 

  226.         /// <param name="cnn">The connection to query on.</param>

    227. 

  227.         /// <param name="type">The type to return.</param>

    228. 

  228.         /// <param name="sql">The SQL to execute for the query.</param>

    229. 

  229.         /// <param name="param">The parameters to pass, if any.</param>

    230. 

  230.         /// <param name="transaction">The transaction to use, if any.</param>

    231. 

  231.         /// <param name="commandTimeout">The command timeout (in seconds).</param>

    232. 

  232.         /// <param name="commandType">The type of command to execute.</param>

    233. 

  233.         /// <exception cref="ArgumentNullException"><paramref name="type"/> is <c>null</c>.</exception>

    234. 

  234.         public static Task<object> QueryFirstOrDefaultAsync(this IDbConnection cnn, Type type, string sql, object param = null, IDbTransaction transaction = null, int? commandTimeout = null, CommandType? commandType = null)

    235. 

  235.         {

    236. 

  236.             if (type == null) throw new ArgumentNullException(nameof(type));

    237. 

  237.             return QueryRowAsync<object>(cnn, Row.FirstOrDefault, type, new CommandDefinition(sql, param, transaction, commandTimeout, commandType, CommandFlags.None, default(CancellationToken)));

    238. 

  238.         }

    239. 

  239.         /// <summary>

    240. 

  240.         /// Execute a single-row query asynchronously using Task.

    241. 

  241.         /// </summary>

    242. 

  242.         /// <param name="cnn">The connection to query on.</param>

    243. 

  243.         /// <param name="type">The type to return.</param>

    244. 

  244.         /// <param name="sql">The SQL to execute for the query.</param>

    245. 

  245.         /// <param name="param">The parameters to pass, if any.</param>

    246. 

  246.         /// <param name="transaction">The transaction to use, if any.</param>

    247. 

  247.         /// <param name="commandTimeout">The command timeout (in seconds).</param>

    248. 

  248.         /// <param name="commandType">The type of command to execute.</param>

    249. 

  249.         /// <exception cref="ArgumentNullException"><paramref name="type"/> is <c>null</c>.</exception>

    250. 

  250.         public static Task<object> QuerySingleAsync(this IDbConnection cnn, Type type, string sql, object param = null, IDbTransaction transaction = null, int? commandTimeout = null, CommandType? commandType = null)

    251. 

  251.         {

    252. 

  252.             if (type == null) throw new ArgumentNullException(nameof(type));

    253. 

  253.             return QueryRowAsync<object>(cnn, Row.Single, type, new CommandDefinition(sql, param, transaction, commandTimeout, commandType, CommandFlags.None, default(CancellationToken)));

    254. 

  254.         }

    255. 

  255.         /// <summary>

    256. 

  256.         /// Execute a single-row query asynchronously using Task.

    257. 

  257.         /// </summary>

    258. 

  258.         /// <param name="cnn">The connection to query on.</param>

    259. 

  259.         /// <param name="type">The type to return.</param>

    260. 

  260.         /// <param name="sql">The SQL to execute for the query.</param>

    261. 

  261.         /// <param name="param">The parameters to pass, if any.</param>

    262. 

  262.         /// <param name="transaction">The transaction to use, if any.</param>

    263. 

  263.         /// <param name="commandTimeout">The command timeout (in seconds).</param>

    264. 

  264.         /// <param name="commandType">The type of command to execute.</param>

    265. 

  265.         /// <exception cref="ArgumentNullException"><paramref name="type"/> is <c>null</c>.</exception>

    266. 

  266.         public static Task<object> QuerySingleOrDefaultAsync(this IDbConnection cnn, Type type, string sql, object param = null, IDbTransaction transaction = null, int? commandTimeout = null, CommandType? commandType = null)

    267. 

  267.         {

    268. 

  268.             if (type == null) throw new ArgumentNullException(nameof(type));

    269. 

  269.             return QueryRowAsync<object>(cnn, Row.SingleOrDefault, type, new CommandDefinition(sql, param, transaction, commandTimeout, commandType, CommandFlags.None, default(CancellationToken)));

    270. 

  270.         }

    271. 

  271. 

    272. 

  272.         /// <summary>

    273. 

  273.         /// Execute a query asynchronously using Task.

    274. 

  274.         /// </summary>

    275. 

  275.         /// <typeparam name="T">The type to return.</typeparam>

    276. 

  276.         /// <param name="cnn">The connection to query on.</param>

    277. 

  277.         /// <param name="command">The command used to query on this connection.</param>

    278. 

  278.         /// <returns>

    279. 

  279.         /// A sequence of data of <typeparamref name="T"/>; if a basic type (int, string, etc) is queried then the data from the first column in assumed, otherwise an instance is

    280. 

  280.         /// created per row, and a direct column-name===member-name mapping is assumed (case insensitive).

    281. 

  281.         /// </returns>

    282. 

  282.         public static Task<IEnumerable<T>> QueryAsync<T>(this IDbConnection cnn, CommandDefinition command) =>

    283. 

  283.             QueryAsync<T>(cnn, typeof(T), command);

    284. 

  284. 

    285. 

  285.         /// <summary>

    286. 

  286.         /// Execute a query asynchronously using Task.

    287. 

  287.         /// </summary>

    288. 

  288.         /// <param name="cnn">The connection to query on.</param>

    289. 

  289.         /// <param name="type">The type to return.</param>

    290. 

  290.         /// <param name="command">The command used to query on this connection.</param>

    291. 

  291.         public static Task<IEnumerable<object>> QueryAsync(this IDbConnection cnn, Type type, CommandDefinition command) =>

    292. 

  292.             QueryAsync<object>(cnn, type, command);

    293. 

  293. 

    294. 

  294.         /// <summary>

    295. 

  295.         /// Execute a single-row query asynchronously using Task.

    296. 

  296.         /// </summary>

    297. 

  297.         /// <param name="cnn">The connection to query on.</param>

    298. 

  298.         /// <param name="type">The type to return.</param>

    299. 

  299.         /// <param name="command">The command used to query on this connection.</param>

    300. 

  300.         public static Task<object> QueryFirstAsync(this IDbConnection cnn, Type type, CommandDefinition command) =>

    301. 

  301.             QueryRowAsync<object>(cnn, Row.First, type, command);

    302. 

  302. 

    303. 

  303.         /// <summary>

    304. 

  304.         /// Execute a single-row query asynchronously using Task.

    305. 

  305.         /// </summary>

    306. 

  306.         /// <typeparam name="T">The type to return.</typeparam>

    307. 

  307.         /// <param name="cnn">The connection to query on.</param>

    308. 

  308.         /// <param name="command">The command used to query on this connection.</param>

    309. 

  309.         public static Task<T> QueryFirstAsync<T>(this IDbConnection cnn, CommandDefinition command) =>

    310. 

  310.             QueryRowAsync<T>(cnn, Row.First, typeof(T), command);

    311. 

  311. 

    312. 

  312.         /// <summary>

    313. 

  313.         /// Execute a single-row query asynchronously using Task.

    314. 

  314.         /// </summary>

    315. 

  315.         /// <param name="cnn">The connection to query on.</param>

    316. 

  316.         /// <param name="type">The type to return.</param>

    317. 

  317.         /// <param name="command">The command used to query on this connection.</param>

    318. 

  318.         public static Task<object> QueryFirstOrDefaultAsync(this IDbConnection cnn, Type type, CommandDefinition command) =>

    319. 

  319.             QueryRowAsync<object>(cnn, Row.FirstOrDefault, type, command);

    320. 

  320. 

    321. 

  321.         /// <summary>

    322. 

  322.         /// Execute a single-row query asynchronously using Task.

    323. 

  323.         /// </summary>

    324. 

  324.         /// <typeparam name="T">The type to return.</typeparam>

    325. 

  325.         /// <param name="cnn">The connection to query on.</param>

    326. 

  326.         /// <param name="command">The command used to query on this connection.</param>

    327. 

  327.         public static Task<T> QueryFirstOrDefaultAsync<T>(this IDbConnection cnn, CommandDefinition command) =>

    328. 

  328.             QueryRowAsync<T>(cnn, Row.FirstOrDefault, typeof(T), command);

    329. 

  329. 

    330. 

  330.         /// <summary>

    331. 

  331.         /// Execute a single-row query asynchronously using Task.

    332. 

  332.         /// </summary>

    333. 

  333.         /// <param name="cnn">The connection to query on.</param>

    334. 

  334.         /// <param name="type">The type to return.</param>

    335. 

  335.         /// <param name="command">The command used to query on this connection.</param>

    336. 

  336.         public static Task<object> QuerySingleAsync(this IDbConnection cnn, Type type, CommandDefinition command) =>

    337. 

  337.             QueryRowAsync<object>(cnn, Row.Single, type, command);

    338. 

  338. 

    339. 

  339.         /// <summary>

    340. 

  340.         /// Execute a single-row query asynchronously using Task.

    341. 

  341.         /// </summary>

    342. 

  342.         /// <typeparam name="T">The type to return.</typeparam>

    343. 

  343.         /// <param name="cnn">The connection to query on.</param>

    344. 

  344.         /// <param name="command">The command used to query on this connection.</param>

    345. 

  345.         public static Task<T> QuerySingleAsync<T>(this IDbConnection cnn, CommandDefinition command) =>

    346. 

  346.             QueryRowAsync<T>(cnn, Row.Single, typeof(T), command);

    347. 

  347. 

    348. 

  348.         /// <summary>

    349. 

  349.         /// Execute a single-row query asynchronously using Task.

    350. 

  350.         /// </summary>

    351. 

  351.         /// <param name="cnn">The connection to query on.</param>

    352. 

  352.         /// <param name="type">The type to return.</param>

    353. 

  353.         /// <param name="command">The command used to query on this connection.</param>

    354. 

  354.         public static Task<object> QuerySingleOrDefaultAsync(this IDbConnection cnn, Type type, CommandDefinition command) =>

    355. 

  355.             QueryRowAsync<object>(cnn, Row.SingleOrDefault, type, command);

    356. 

  356. 

    357. 

  357.         /// <summary>

    358. 

  358.         /// Execute a single-row query asynchronously using Task.

    359. 

  359.         /// </summary>

    360. 

  360.         /// <typeparam name="T">The type to return.</typeparam>

    361. 

  361.         /// <param name="cnn">The connection to query on.</param>

    362. 

  362.         /// <param name="command">The command used to query on this connection.</param>

    363. 

  363.         public static Task<T> QuerySingleOrDefaultAsync<T>(this IDbConnection cnn, CommandDefinition command) =>

    364. 

  364.             QueryRowAsync<T>(cnn, Row.SingleOrDefault, typeof(T), command);

    365. 

  365. 

    366. 

  366.         private static Task<DbDataReader> ExecuteReaderWithFlagsFallbackAsync(DbCommand cmd, bool wasClosed, CommandBehavior behavior, CancellationToken cancellationToken)

    367. 

  367.         {

    368. 

  368.             var task = cmd.ExecuteReaderAsync(GetBehavior(wasClosed, behavior), cancellationToken);

    369. 

  369.             if (task.Status == TaskStatus.Faulted && Settings.DisableCommandBehaviorOptimizations(behavior, task.Exception.InnerException))

    370. 

  370.             { // we can retry; this time it will have different flags

    371. 

  371.                 return cmd.ExecuteReaderAsync(GetBehavior(wasClosed, behavior), cancellationToken);

    372. 

  372.             }

    373. 

  373.             return task;

    374. 

  374.         }

    375. 

  375. 

    376. 

  376.         /// <summary>

    377. 

  377.         /// Attempts to open a connection asynchronously, with a better error message for unsupported usages.

    378. 

  378.         /// </summary>

    379. 

  379.         private static Task TryOpenAsync(this IDbConnection cnn, CancellationToken cancel)

    380. 

  380.         {

    381. 

  381.             if (cnn is DbConnection dbConn)

    382. 

  382.             {

    383. 

  383.                 return dbConn.OpenAsync(cancel);

    384. 

  384.             }

    385. 

  385.             else

    386. 

  386.             {

    387. 

  387.                 throw new InvalidOperationException("Async operations require use of a DbConnection or an already-open IDbConnection");

    388. 

  388.             }

    389. 

  389.         }

    390. 

  390. 

    391. 

  391.         /// <summary>

    392. 

  392.         /// Attempts setup a <see cref="DbCommand"/> on a <see cref="DbConnection"/>, with a better error message for unsupported usages.

    393. 

  393.         /// </summary>

    394. 

  394.         private static DbCommand TrySetupAsyncCommand(this CommandDefinition command, IDbConnection cnn, Action<IDbCommand, object> paramReader)

    395. 

  395.         {

    396. 

  396.             if (command.SetupCommand(cnn, paramReader) is DbCommand dbCommand)

    397. 

  397.             {

    398. 

  398.                 return dbCommand;

    399. 

  399.             }

    400. 

  400.             else

    401. 

  401.             {

    402. 

  402.                 throw new InvalidOperationException("Async operations require use of a DbConnection or an IDbConnection where .CreateCommand() returns a DbCommand");

    403. 

  403.             }

    404. 

  404.         }

    405. 

  405. 

    406. 

  406.         private static async Task<IEnumerable<T>> QueryAsync<T>(this IDbConnection cnn, Type effectiveType, CommandDefinition command)

    407. 

  407.         {

    408. 

  408.             object param = command.Parameters;

    409. 

  409.             var identity = new Identity(command.CommandText, command.CommandType, cnn, effectiveType, param?.GetType());

    410. 

  410.             var info = GetCacheInfo(identity, param, command.AddToCache);

    411. 

  411.             bool wasClosed = cnn.State == ConnectionState.Closed;

    412. 

  412.             var cancel = command.CancellationToken;

    413. 

  413.             using (var cmd = command.TrySetupAsyncCommand(cnn, info.ParamReader))

    414. 

  414.             {

    415. 

  415.                 DbDataReader reader = null;

    416. 

  416.                 try

    417. 

  417.                 {

    418. 

  418.                     if (wasClosed) await cnn.TryOpenAsync(cancel).ConfigureAwait(false);

    419. 

  419.                     reader = await ExecuteReaderWithFlagsFallbackAsync(cmd, wasClosed, CommandBehavior.SequentialAccess | CommandBehavior.SingleResult, cancel).ConfigureAwait(false);

    420. 

  420. 

    421. 

  421.                     var tuple = info.Deserializer;

    422. 

  422.                     int hash = GetColumnHash(reader);

    423. 

  423.                     if (tuple.Func == null || tuple.Hash != hash)

    424. 

  424.                     {

    425. 

  425.                         if (reader.FieldCount == 0)

    426. 

  426.                             return Enumerable.Empty<T>();

    427. 

  427.                         tuple = info.Deserializer = new DeserializerState(hash, GetDeserializer(effectiveType, reader, 0, -1, false));

    428. 

  428.                         if (command.AddToCache) SetQueryCache(identity, info);

    429. 

  429.                     }

    430. 

  430. 

    431. 

  431.                     var func = tuple.Func;

    432. 

  432. 

    433. 

  433.                     if (command.Buffered)

    434. 

  434.                     {

    435. 

  435.                         var buffer = new List<T>();

    436. 

  436.                         var convertToType = Nullable.GetUnderlyingType(effectiveType) ?? effectiveType;

    437. 

  437.                         while (await reader.ReadAsync(cancel).ConfigureAwait(false))

    438. 

  438.                         {

    439. 

  439.                             object val = func(reader);

    440. 

  440.                             buffer.Add(GetValue<T>(reader, effectiveType, val));

    441. 

  441.                         }

    442. 

  442.                         while (await reader.NextResultAsync(cancel).ConfigureAwait(false)) { /* ignore subsequent result sets */ }

    443. 

  443.                         command.OnCompleted();

    444. 

  444.                         return buffer;

    445. 

  445.                     }

    446. 

  446.                     else

    447. 

  447.                     {

    448. 

  448.                         // can't use ReadAsync / cancellation; but this will have to do

    449. 

  449.                         wasClosed = false; // don't close if handing back an open reader; rely on the command-behavior

    450. 

  450.                         var deferred = ExecuteReaderSync<T>(reader, func, command.Parameters);

    451. 

  451.                         reader = null; // to prevent it being disposed before the caller gets to see it

    452. 

  452.                         return deferred;

    453. 

  453.                     }

    454. 

  454.                 }

    455. 

  455.                 finally

    456. 

  456.                 {

    457. 

  457.                     using (reader) { /* dispose if non-null */ }

    458. 

  458.                     if (wasClosed) cnn.Close();

    459. 

  459.                 }

    460. 

  460.             }

    461. 

  461.         }

    462. 

  462. 

    463. 

  463.         private static async Task<T> QueryRowAsync<T>(this IDbConnection cnn, Row row, Type effectiveType, CommandDefinition command)

    464. 

  464.         {

    465. 

  465.             object param = command.Parameters;

    466. 

  466.             var identity = new Identity(command.CommandText, command.CommandType, cnn, effectiveType, param?.GetType());

    467. 

  467.             var info = GetCacheInfo(identity, param, command.AddToCache);

    468. 

  468.             bool wasClosed = cnn.State == ConnectionState.Closed;

    469. 

  469.             var cancel = command.CancellationToken;

    470. 

  470.             using (var cmd = command.TrySetupAsyncCommand(cnn, info.ParamReader))

    471. 

  471.             {

    472. 

  472.                 DbDataReader reader = null;

    473. 

  473.                 try

    474. 

  474.                 {

    475. 

  475.                     if (wasClosed) await cnn.TryOpenAsync(cancel).ConfigureAwait(false);

    476. 

  476.                     reader = await ExecuteReaderWithFlagsFallbackAsync(cmd, wasClosed, (row & Row.Single) != 0

    477. 

  477.                     ? CommandBehavior.SequentialAccess | CommandBehavior.SingleResult // need to allow multiple rows, to check fail condition

    478. 

  478.                     : CommandBehavior.SequentialAccess | CommandBehavior.SingleResult | CommandBehavior.SingleRow, cancel).ConfigureAwait(false);

    479. 

  479. 

    480. 

  480.                     T result = default;

    481. 

  481.                     if (await reader.ReadAsync(cancel).ConfigureAwait(false) && reader.FieldCount != 0)

    482. 

  482.                     {

    483. 

  483.                         result = ReadRow<T>(info, identity, ref command, effectiveType, reader);

    484. 

  484. 

    485. 

  485.                         if ((row & Row.Single) != 0 && await reader.ReadAsync(cancel).ConfigureAwait(false)) ThrowMultipleRows(row);

    486. 

  486.                         while (await reader.ReadAsync(cancel).ConfigureAwait(false)) { /* ignore rows after the first */ }

    487. 

  487.                     }

    488. 

  488.                     else if ((row & Row.FirstOrDefault) == 0) // demanding a row, and don't have one

    489. 

  489.                     {

    490. 

  490.                         ThrowZeroRows(row);

    491. 

  491.                     }

    492. 

  492.                     while (await reader.NextResultAsync(cancel).ConfigureAwait(false)) { /* ignore result sets after the first */ }

    493. 

  493.                     return result;

    494. 

  494.                 }

    495. 

  495.                 finally

    496. 

  496.                 {

    497. 

  497.                     using (reader) { /* dispose if non-null */ }

    498. 

  498.                     if (wasClosed) cnn.Close();

    499. 

  499.                 }

    500. 

  500.             }

    501. 

  501.         }

    502. 

  502. 

    503. 

  503.         /// <summary>

    504. 

  504.         /// Execute a command asynchronously using Task.

    505. 

  505.         /// </summary>

    506. 

  506.         /// <param name="cnn">The connection to query on.</param>

    507. 

  507.         /// <param name="sql">The SQL to execute for this query.</param>

    508. 

  508.         /// <param name="param">The parameters to use for this query.</param>

    509. 

  509.         /// <param name="transaction">The transaction to use for this query.</param>

    510. 

  510.         /// <param name="commandTimeout">Number of seconds before command execution timeout.</param>

    511. 

  511.         /// <param name="commandType">Is it a stored proc or a batch?</param>

    512. 

  512.         /// <returns>The number of rows affected.</returns>

    513. 

  513.         public static Task<int> ExecuteAsync(this IDbConnection cnn, string sql, object param = null, IDbTransaction transaction = null, int? commandTimeout = null, CommandType? commandType = null) =>

    514. 

  514.             ExecuteAsync(cnn, new CommandDefinition(sql, param, transaction, commandTimeout, commandType, CommandFlags.Buffered, default(CancellationToken)));

    515. 

  515. 

    516. 

  516.         /// <summary>

    517. 

  517.         /// Execute a command asynchronously using Task.

    518. 

  518.         /// </summary>

    519. 

  519.         /// <param name="cnn">The connection to execute on.</param>

    520. 

  520.         /// <param name="command">The command to execute on this connection.</param>

    521. 

  521.         /// <returns>The number of rows affected.</returns>

    522. 

  522.         public static Task<int> ExecuteAsync(this IDbConnection cnn, CommandDefinition command)

    523. 

  523.         {

    524. 

  524.             object param = command.Parameters;

    525. 

  525.             IEnumerable multiExec = GetMultiExec(param);

    526. 

  526.             if (multiExec != null)

    527. 

  527.             {

    528. 

  528.                 return ExecuteMultiImplAsync(cnn, command, multiExec);

    529. 

  529.             }

    530. 

  530.             else

    531. 

  531.             {

    532. 

  532.                 return ExecuteImplAsync(cnn, command, param);

    533. 

  533.             }

    534. 

  534.         }

    535. 

  535. 

    536. 

  536.         private struct AsyncExecState

    537. 

  537.         {

    538. 

  538.             public readonly DbCommand Command;

    539. 

  539.             public readonly Task<int> Task;

    540. 

  540.             public AsyncExecState(DbCommand command, Task<int> task)

    541. 

  541.             {

    542. 

  542.                 Command = command;

    543. 

  543.                 Task = task;

    544. 

  544.             }

    545. 

  545.         }

    546. 

  546. 

    547. 

  547.         private static async Task<int> ExecuteMultiImplAsync(IDbConnection cnn, CommandDefinition command, IEnumerable multiExec)

    548. 

  548.         {

    549. 

  549.             bool isFirst = true;

    550. 

  550.             int total = 0;

    551. 

  551.             bool wasClosed = cnn.State == ConnectionState.Closed;

    552. 

  552.             try

    553. 

  553.             {

    554. 

  554.                 if (wasClosed) await cnn.TryOpenAsync(command.CancellationToken).ConfigureAwait(false);

    555. 

  555. 

    556. 

  556.                 CacheInfo info = null;

    557. 

  557.                 string masterSql = null;

    558. 

  558.                 if ((command.Flags & CommandFlags.Pipelined) != 0)

    559. 

  559.                 {

    560. 

  560.                     const int MAX_PENDING = 100;

    561. 

  561.                     var pending = new Queue<AsyncExecState>(MAX_PENDING);

    562. 

  562.                     DbCommand cmd = null;

    563. 

  563.                     try

    564. 

  564.                     {

    565. 

  565.                         foreach (var obj in multiExec)

    566. 

  566.                         {

    567. 

  567.                             if (isFirst)

    568. 

  568.                             {

    569. 

  569.                                 isFirst = false;

    570. 

  570.                                 cmd = command.TrySetupAsyncCommand(cnn, null);

    571. 

  571.                                 masterSql = cmd.CommandText;

    572. 

  572.                                 var identity = new Identity(command.CommandText, cmd.CommandType, cnn, null, obj.GetType());

    573. 

  573.                                 info = GetCacheInfo(identity, obj, command.AddToCache);

    574. 

  574.                             }

    575. 

  575.                             else if (pending.Count >= MAX_PENDING)

    576. 

  576.                             {

    577. 

  577.                                 var recycled = pending.Dequeue();

    578. 

  578.                                 total += await recycled.Task.ConfigureAwait(false);

    579. 

  579.                                 cmd = recycled.Command;

    580. 

  580.                                 cmd.CommandText = masterSql; // because we do magic replaces on "in" etc

    581. 

  581.                                 cmd.Parameters.Clear(); // current code is Add-tastic

    582. 

  582.                             }

    583. 

  583.                             else

    584. 

  584.                             {

    585. 

  585.                                 cmd = command.TrySetupAsyncCommand(cnn, null);

    586. 

  586.                             }

    587. 

  587.                             info.ParamReader(cmd, obj);

    588. 

  588. 

    589. 

  589.                             var task = cmd.ExecuteNonQueryAsync(command.CancellationToken);

    590. 

  590.                             pending.Enqueue(new AsyncExecState(cmd, task));

    591. 

  591.                             cmd = null; // note the using in the finally: this avoids a double-dispose

    592. 

  592.                         }

    593. 

  593.                         while (pending.Count != 0)

    594. 

  594.                         {

    595. 

  595.                             var pair = pending.Dequeue();

    596. 

  596.                             using (pair.Command) { /* dispose commands */ }

    597. 

  597.                             total += await pair.Task.ConfigureAwait(false);

    598. 

  598.                         }

    599. 

  599.                     }

    600. 

  600.                     finally

    601. 

  601.                     {

    602. 

  602.                         // this only has interesting work to do if there are failures

    603. 

  603.                         using (cmd) { /* dispose commands */ }

    604. 

  604.                         while (pending.Count != 0)

    605. 

  605.                         { // dispose tasks even in failure

    606. 

  606.                             using (pending.Dequeue().Command) { /* dispose commands */ }

    607. 

  607.                         }

    608. 

  608.                     }

    609. 

  609.                 }

    610. 

  610.                 else

    611. 

  611.                 {

    612. 

  612.                     using (var cmd = command.TrySetupAsyncCommand(cnn, null))

    613. 

  613.                     {

    614. 

  614.                         foreach (var obj in multiExec)

    615. 

  615.                         {

    616. 

  616.                             if (isFirst)

    617. 

  617.                             {

    618. 

  618.                                 masterSql = cmd.CommandText;

    619. 

  619.                                 isFirst = false;

    620. 

  620.                                 var identity = new Identity(command.CommandText, cmd.CommandType, cnn, null, obj.GetType());

    621. 

  621.                                 info = GetCacheInfo(identity, obj, command.AddToCache);

    622. 

  622.                             }

    623. 

  623.                             else

    624. 

  624.                             {

    625. 

  625.                                 cmd.CommandText = masterSql; // because we do magic replaces on "in" etc

    626. 

  626.                                 cmd.Parameters.Clear(); // current code is Add-tastic

    627. 

  627.                             }

    628. 

  628.                             info.ParamReader(cmd, obj);

    629. 

  629.                             total += await cmd.ExecuteNonQueryAsync(command.CancellationToken).ConfigureAwait(false);

    630. 

  630.                         }

    631. 

  631.                     }

    632. 

  632.                 }

    633. 

  633. 

    634. 

  634.                 command.OnCompleted();

    635. 

  635.             }

    636. 

  636.             finally

    637. 

  637.             {

    638. 

  638.                 if (wasClosed) cnn.Close();

    639. 

  639.             }

    640. 

  640.             return total;

    641. 

  641.         }

    642. 

  642. 

    643. 

  643.         private static async Task<int> ExecuteImplAsync(IDbConnection cnn, CommandDefinition command, object param)

    644. 

  644.         {

    645. 

  645.             var identity = new Identity(command.CommandText, command.CommandType, cnn, null, param?.GetType());

    646. 

  646.             var info = GetCacheInfo(identity, param, command.AddToCache);

    647. 

  647.             bool wasClosed = cnn.State == ConnectionState.Closed;

    648. 

  648.             using (var cmd = command.TrySetupAsyncCommand(cnn, info.ParamReader))

    649. 

  649.             {

    650. 

  650.                 try

    651. 

  651.                 {

    652. 

  652.                     if (wasClosed) await cnn.TryOpenAsync(command.CancellationToken).ConfigureAwait(false);

    653. 

  653.                     var result = await cmd.ExecuteNonQueryAsync(command.CancellationToken).ConfigureAwait(false);

    654. 

  654.                     command.OnCompleted();

    655. 

  655.                     return result;

    656. 

  656.                 }

    657. 

  657.                 finally

    658. 

  658.                 {

    659. 

  659.                     if (wasClosed) cnn.Close();

    660. 

  660.                 }

    661. 

  661.             }

    662. 

  662.         }

    663. 

  663. 

    664. 

  664.         /// <summary>

    665. 

  665.         /// Perform a asynchronous multi-mapping query with 2 input types.

    666. 

  666.         /// This returns a single type, combined from the raw types via <paramref name="map"/>.

    667. 

  667.         /// </summary>

    668. 

  668.         /// <typeparam name="TFirst">The first type in the recordset.</typeparam>

    669. 

  669.         /// <typeparam name="TSecond">The second type in the recordset.</typeparam>

    670. 

  670.         /// <typeparam name="TReturn">The combined type to return.</typeparam>

    671. 

  671.         /// <param name="cnn">The connection to query on.</param>

    672. 

  672.         /// <param name="sql">The SQL to execute for this query.</param>

    673. 

  673.         /// <param name="map">The function to map row types to the return type.</param>

    674. 

  674.         /// <param name="param">The parameters to use for this query.</param>

    675. 

  675.         /// <param name="transaction">The transaction to use for this query.</param>

    676. 

  676.         /// <param name="buffered">Whether to buffer the results in memory.</param>

    677. 

  677.         /// <param name="splitOn">The field we should split and read the second object from (default: "Id").</param>

    678. 

  678.         /// <param name="commandTimeout">Number of seconds before command execution timeout.</param>

    679. 

  679.         /// <param name="commandType">Is it a stored proc or a batch?</param>

    680. 

  680.         /// <returns>An enumerable of <typeparamref name="TReturn"/>.</returns>

    681. 

  681.         public static Task<IEnumerable<TReturn>> QueryAsync<TFirst, TSecond, TReturn>(this IDbConnection cnn, string sql, Func<TFirst, TSecond, TReturn> map, object param = null, IDbTransaction transaction = null, bool buffered = true, string splitOn = "Id", int? commandTimeout = null, CommandType? commandType = null) =>

    682. 

  682.             MultiMapAsync<TFirst, TSecond, DontMap, DontMap, DontMap, DontMap, DontMap, TReturn>(cnn,

    683. 

  683.                 new CommandDefinition(sql, param, transaction, commandTimeout, commandType, buffered ? CommandFlags.Buffered : CommandFlags.None, default(CancellationToken)), map, splitOn);

    684. 

  684. 

    685. 

  685.         /// <summary>

    686. 

  686.         /// Perform a asynchronous multi-mapping query with 2 input types.

    687. 

  687.         /// This returns a single type, combined from the raw types via <paramref name="map"/>.

    688. 

  688.         /// </summary>

    689. 

  689.         /// <typeparam name="TFirst">The first type in the recordset.</typeparam>

    690. 

  690.         /// <typeparam name="TSecond">The second type in the recordset.</typeparam>

    691. 

  691.         /// <typeparam name="TReturn">The combined type to return.</typeparam>

    692. 

  692.         /// <param name="cnn">The connection to query on.</param>

    693. 

  693.         /// <param name="splitOn">The field we should split and read the second object from (default: "Id").</param>

    694. 

  694.         /// <param name="command">The command to execute.</param>

    695. 

  695.         /// <param name="map">The function to map row types to the return type.</param>

    696. 

  696.         /// <returns>An enumerable of <typeparamref name="TReturn"/>.</returns>

    697. 

  697.         public static Task<IEnumerable<TReturn>> QueryAsync<TFirst, TSecond, TReturn>(this IDbConnection cnn, CommandDefinition command, Func<TFirst, TSecond, TReturn> map, string splitOn = "Id") =>

    698. 

  698.             MultiMapAsync<TFirst, TSecond, DontMap, DontMap, DontMap, DontMap, DontMap, TReturn>(cnn, command, map, splitOn);

    699. 

  699. 

    700. 

  700.         /// <summary>

    701. 

  701.         /// Perform a asynchronous multi-mapping query with 3 input types.

    702. 

  702.         /// This returns a single type, combined from the raw types via <paramref name="map"/>.

    703. 

  703.         /// </summary>

    704. 

  704.         /// <typeparam name="TFirst">The first type in the recordset.</typeparam>

    705. 

  705.         /// <typeparam name="TSecond">The second type in the recordset.</typeparam>

    706. 

  706.         /// <typeparam name="TThird">The third type in the recordset.</typeparam>

    707. 

  707.         /// <typeparam name="TReturn">The combined type to return.</typeparam>

    708. 

  708.         /// <param name="cnn">The connection to query on.</param>

    709. 

  709.         /// <param name="sql">The SQL to execute for this query.</param>

    710. 

  710.         /// <param name="map">The function to map row types to the return type.</param>

    711. 

  711.         /// <param name="param">The parameters to use for this query.</param>

    712. 

  712.         /// <param name="transaction">The transaction to use for this query.</param>

    713. 

  713.         /// <param name="buffered">Whether to buffer the results in memory.</param>

    714. 

  714.         /// <param name="splitOn">The field we should split and read the second object from (default: "Id").</param>

    715. 

  715.         /// <param name="commandTimeout">Number of seconds before command execution timeout.</param>

    716. 

  716.         /// <param name="commandType">Is it a stored proc or a batch?</param>

    717. 

  717.         /// <returns>An enumerable of <typeparamref name="TReturn"/>.</returns>

    718. 

  718.         public static Task<IEnumerable<TReturn>> QueryAsync<TFirst, TSecond, TThird, TReturn>(this IDbConnection cnn, string sql, Func<TFirst, TSecond, TThird, TReturn> map, object param = null, IDbTransaction transaction = null, bool buffered = true, string splitOn = "Id", int? commandTimeout = null, CommandType? commandType = null) =>

    719. 

  719.             MultiMapAsync<TFirst, TSecond, TThird, DontMap, DontMap, DontMap, DontMap, TReturn>(cnn,

    720. 

  720.                 new CommandDefinition(sql, param, transaction, commandTimeout, commandType, buffered ? CommandFlags.Buffered : CommandFlags.None, default(CancellationToken)), map, splitOn);

    721. 

  721. 

    722. 

  722.         /// <summary>

    723. 

  723.         /// Perform a asynchronous multi-mapping query with 3 input types.

    724. 

  724.         /// This returns a single type, combined from the raw types via <paramref name="map"/>.

    725. 

  725.         /// </summary>

    726. 

  726.         /// <typeparam name="TFirst">The first type in the recordset.</typeparam>

    727. 

  727.         /// <typeparam name="TSecond">The second type in the recordset.</typeparam>

    728. 

  728.         /// <typeparam name="TThird">The third type in the recordset.</typeparam>

    729. 

  729.         /// <typeparam name="TReturn">The combined type to return.</typeparam>

    730. 

  730.         /// <param name="cnn">The connection to query on.</param>

    731. 

  731.         /// <param name="splitOn">The field we should split and read the second object from (default: "Id").</param>

    732. 

  732.         /// <param name="command">The command to execute.</param>

    733. 

  733.         /// <param name="map">The function to map row types to the return type.</param>

    734. 

  734.         /// <returns>An enumerable of <typeparamref name="TReturn"/>.</returns>

    735. 

  735.         public static Task<IEnumerable<TReturn>> QueryAsync<TFirst, TSecond, TThird, TReturn>(this IDbConnection cnn, CommandDefinition command, Func<TFirst, TSecond, TThird, TReturn> map, string splitOn = "Id") =>

    736. 

  736.             MultiMapAsync<TFirst, TSecond, TThird, DontMap, DontMap, DontMap, DontMap, TReturn>(cnn, command, map, splitOn);

    737. 

  737. 

    738. 

  738.         /// <summary>

    739. 

  739.         /// Perform a asynchronous multi-mapping query with 4 input types.

    740. 

  740.         /// This returns a single type, combined from the raw types via <paramref name="map"/>.

    741. 

  741.         /// </summary>

    742. 

  742.         /// <typeparam name="TFirst">The first type in the recordset.</typeparam>

    743. 

  743.         /// <typeparam name="TSecond">The second type in the recordset.</typeparam>

    744. 

  744.         /// <typeparam name="TThird">The third type in the recordset.</typeparam>

    745. 

  745.         /// <typeparam name="TFourth">The fourth type in the recordset.</typeparam>

    746. 

  746.         /// <typeparam name="TReturn">The combined type to return.</typeparam>

    747. 

  747.         /// <param name="cnn">The connection to query on.</param>

    748. 

  748.         /// <param name="sql">The SQL to execute for this query.</param>

    749. 

  749.         /// <param name="map">The function to map row types to the return type.</param>

    750. 

  750.         /// <param name="param">The parameters to use for this query.</param>

    751. 

  751.         /// <param name="transaction">The transaction to use for this query.</param>

    752. 

  752.         /// <param name="buffered">Whether to buffer the results in memory.</param>

    753. 

  753.         /// <param name="splitOn">The field we should split and read the second object from (default: "Id").</param>

    754. 

  754.         /// <param name="commandTimeout">Number of seconds before command execution timeout.</param>

    755. 

  755.         /// <param name="commandType">Is it a stored proc or a batch?</param>

    756. 

  756.         /// <returns>An enumerable of <typeparamref name="TReturn"/>.</returns>

    757. 

  757.         public static Task<IEnumerable<TReturn>> QueryAsync<TFirst, TSecond, TThird, TFourth, TReturn>(this IDbConnection cnn, string sql, Func<TFirst, TSecond, TThird, TFourth, TReturn> map, object param = null, IDbTransaction transaction = null, bool buffered = true, string splitOn = "Id", int? commandTimeout = null, CommandType? commandType = null) =>

    758. 

  758.             MultiMapAsync<TFirst, TSecond, TThird, TFourth, DontMap, DontMap, DontMap, TReturn>(cnn,

    759. 

  759.                 new CommandDefinition(sql, param, transaction, commandTimeout, commandType, buffered ? CommandFlags.Buffered : CommandFlags.None, default(CancellationToken)), map, splitOn);

    760. 

  760. 

    761. 

  761.         /// <summary>

    762. 

  762.         /// Perform a asynchronous multi-mapping query with 4 input types.

    763. 

  763.         /// This returns a single type, combined from the raw types via <paramref name="map"/>.

    764. 

  764.         /// </summary>

    765. 

  765.         /// <typeparam name="TFirst">The first type in the recordset.</typeparam>

    766. 

  766.         /// <typeparam name="TSecond">The second type in the recordset.</typeparam>

    767. 

  767.         /// <typeparam name="TThird">The third type in the recordset.</typeparam>

    768. 

  768.         /// <typeparam name="TFourth">The fourth type in the recordset.</typeparam>

    769. 

  769.         /// <typeparam name="TReturn">The combined type to return.</typeparam>…
    770.