Dapper官方文档(二)【方法之Execute】

冷不防 2021-07-04 18:49 670阅读 0赞

## 描述 ##

`Execute`是一个可以从`IDbConnection`类型的任意对象调用的扩展方法，它可以执行一个或多个命令并返回受影响的行数。此方法通常用于执行：

*  存储过程
 *  INSERT语句
 *  UPDATE语句
 *  DELETE语句

### 参数 ###

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

<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>

## 案例 - 执行存储过程 ##

### 单次 ###

执行一次存储过程。

string sql = "Invoice_Insert";
    
    using (var connection = My.ConnectionFactory())
    { 
        connection.Open();
    
        var affectedRows = connection.Execute(sql,
            new { Kind = InvoiceKind.WebInvoice, Code = "Single_Insert_1"},
            commandType: CommandType.StoredProcedure);
    
        My.Result.Show(affectedRows);
    }

### 多次 ###

执行多次存储过程，为参数数组列表中的每个对象执行一次。

string sql = "Invoice_Insert";
    
    using (var connection = My.ConnectionFactory())
    { 
        connection.Open();
    
        var affectedRows = 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
        );
    
        My.Result.Show(affectedRows);
    }

## 案例 - 执行INSERT语句 ##

### 单次 ###

执行一次`INSERT`语句。

### 多次 ###

执行`INSERT`语句，为参数数组列表中的每个对象执行一次。

string sql = "INSERT INTO Invoice (Code) Values (@Code);";
    
    using (var connection = My.ConnectionFactory())
    { 
        connection.Open();
    
        var affectedRows = 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"}
            }
        );
    
        My.Result.Show(affectedRows);
    }

## 案例 - 执行UPDATE语句 ##

### 单次 ###

执行一次`UPDATE`语句。

### 多次 ###

执行`UPDATE`语句，为参数数组列表中的每个对象执行一次。

string sql = "UPDATE Invoice SET Code = @Code WHERE InvoiceID = @InvoiceID";
    
    using (var connection = My.ConnectionFactory())
    { 
        connection.Open();
    
        var affectedRows = connection.Execute(sql,
            new[]
            { 
                new { InvoiceID = 1, Code = "Many_Update_1"},
                new { InvoiceID = 2, Code = "Many_Update_2"},
                new { InvoiceID = 3, Code = "Many_Update_3"}
            });
    
        My.Result.Show(affectedRows);
    }

## 案例 - 执行DELETE语句 ##

### 单次 ###

执行一次`DELETE`语句。

string sql = "DELETE FROM Invoice WHERE InvoiceID = @InvoiceID";
    
    using (var connection = My.ConnectionFactory())
    { 
        connection.Open();
    
        var affectedRows = connection.Execute(sql, new { InvoiceID = 1});
    
        My.Result.Show(affectedRows);
    }

### 多次 ###

执行`DELETE`语句，为参数数组列表中的每个对象执行一次。

string sql = "DELETE FROM Invoice WHERE InvoiceID = @InvoiceID";
    
    using (var connection = My.ConnectionFactory())
    { 
        connection.Open();
    
        var affectedRows = connection.Execute(sql,
            new[]
            { 
                new { InvoiceID = 1},
                new { InvoiceID = 2},
                new { InvoiceID = 3}
            });
    }