Dapper官方文档(四)【方法之QueryFirst,QueryFirstOrDefault】

喜欢ヅ旅行 2021-07-05 02:59 789阅读 0赞

# `QueryFirst` #

## 描述 ##

`QueryFirst`是一个可以从`IDbConnection`类型的任意对象调用的扩展方法，它可以执行查询并映射第一个结果。

结果可以映射到：

*  匿名类型
 *  强类型

### 参数 ###

下表显示了`QueryFirst`方法的不同参数。

<table> 
 <thead> 
  <tr> 
   <th>名称</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>sql</td> 
   <td>要执行的查询。</td> 
  </tr> 
  <tr> 
   <td>param</td> 
   <td>查询参数（默认为<code>null</code>）。</td> 
  </tr> 
  <tr> 
   <td>transaction</td> 
   <td>需要使用的事务（默认为<code>null</code>）。</td> 
  </tr> 
  <tr> 
   <td>commandTimeout</td> 
   <td>命令执行超时时间（默认为<code>null</code>）。</td> 
  </tr> 
  <tr> 
   <td>commandType</td> 
   <td>命令类型（默认为<code>null</code>）。</td> 
  </tr> 
 </tbody> 
</table>

### First, Single & Default ###

注意使用正确的方法。`First`和`Single`的方法是非常不同的。

<table> 
 <thead> 
  <tr> 
   <th>结果</th> 
   <th>没有项</th> 
   <th>有一项</th> 
   <th>有多项</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>First</td> 
   <td>抛异常</td> 
   <td>当前项</td> 
   <td>第一项</td> 
  </tr> 
  <tr> 
   <td>Single</td> 
   <td>抛异常</td> 
   <td>当前项</td> 
   <td>抛异常</td> 
  </tr> 
  <tr> 
   <td>FirstOrDefault</td> 
   <td>默认值</td> 
   <td>当前项</td> 
   <td>第一项</td> 
  </tr> 
  <tr> 
   <td>SingleOrDefault</td> 
   <td>默认值</td> 
   <td>当前项</td> 
   <td>抛异常</td> 
  </tr> 
 </tbody> 
</table>

## 案例 - 查询匿名类型 ##

执行查询并将第一个结果映射到动态类型列表。

string sql = "SELECT * FROM Invoice WHERE InvoiceID = @InvoiceID;";
    
    using (var connection = My.ConnectionFactory())
    { 
        connection.Open();
    
        var invoice = connection.QueryFirst(sql, new { InvoiceID = 1});
    }

## 案例 - 查询强类型 ##

执行查询并将第一个结果映射到强类型列表。

--------------------

# `QueryFirstOrDefault` #