Dapper官方文档(五)【方法之QuerySingle,QuerySingleOrDefault,QueryMultiple】

布满荆棘的人生 2021-07-04 17:04 614阅读 0赞

# `QuerySingle` #

## 描述 ##

`QuerySingle`是一个可以从`IDbConnection`类型的任意对象调用的扩展方法，它可以执行查询并映射第一个结果，如果序列中没有元素则会引发异常。

结果可以映射到：

*  匿名类型
 *  强类型

### 参数 ###

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

<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.QuerySingle(sql, new { InvoiceID = 1});
    }

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

执行查询并将第一个结果映射到强类型列表，如果序列中没有元素则会引发异常。

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

# `QuerySingleOrDefault` #

## 描述 ##

`QuerySingleOrDefault`是一个可以从`IDbConnection`类型的任意对象调用的扩展方法，它可以执行查询并映射第一个结果，如果序列为空则为默认值。如果序列中有多个元素，则此方法将引发异常。

结果可以映射到：

*  匿名类型
 *  强类型

### 参数 ###

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

### First, Single & Default ###

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

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

执行查询并将第一个结果映射到动态类型列表，如果序列为空则为默认值。如果序列中有多个元素，则此方法将引发异常。

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

执行查询并将第一个结果映射到强类型列表，如果序列为空则为默认值。如果序列中有多个元素，则此方法将引发异常。

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

# `QueryMultiple` #

## 描述 ##

`QueryMultiple`是一个可以从`IDbConnection`类型的任意对象调用的扩展方法，它可以在相同的命令和映射结果中执行多个查询。

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();
        }
    }

### 参数 ###

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