Database.ExecuteSqlCommandAsync 方法 (String, CancellationToken, Object[])
[此頁面專屬於 Entity Framework 第 6 版。最新版本可從 'Entity Framework' NuGet 套件取得。如需 Entity Framework 的詳細資訊,請參閱 msdn.com/data/ef。]
針對資料庫以非同步方式執行給定的 DDL/DML 命令。 如同所有接受 SQL 的應用程式開發介面,任何使用者輸入都務必進行參數化以防範 SQL 插入式攻擊。 您可在 SQL 查詢字串中加入參數預留位置,然後再以其他引數提供參數值。 您所提供的任何參數值都將自動轉換為 DbParameter。 context.Database.ExecuteSqlCommandAsync("UPDATE dbo.Posts SET Rating = 5 WHERE Author = @p0", userSuppliedAuthor)。或者,您也可以建構 DbParameter 再將其提供給 SqlQuery。 如此您便能在 SQL 查詢字串中使用具名參數。 context.Database.ExecuteSqlCommandAsync("UPDATE dbo.Posts SET Rating = 5 WHERE Author = @author", new SqlParameter("@author", userSuppliedAuthor));
命名空間: System.Data.Entity
組件: EntityFramework (在 EntityFramework.dll 中)
語法
'宣告
Public Function ExecuteSqlCommandAsync ( _
sql As String, _
cancellationToken As CancellationToken, _
ParamArray parameters As Object() _
) As Task(Of Integer)
'用途
Dim instance As Database
Dim sql As String
Dim cancellationToken As CancellationToken
Dim parameters As Object()
Dim returnValue As Task(Of Integer)
returnValue = instance.ExecuteSqlCommandAsync(sql, _
cancellationToken, parameters)
public Task<int> ExecuteSqlCommandAsync(
string sql,
CancellationToken cancellationToken,
params Object[] parameters
)
public:
Task<int>^ ExecuteSqlCommandAsync(
String^ sql,
CancellationToken cancellationToken,
... array<Object^>^ parameters
)
member ExecuteSqlCommandAsync :
sql:string *
cancellationToken:CancellationToken *
parameters:Object[] -> Task<int>
public function ExecuteSqlCommandAsync(
sql : String,
cancellationToken : CancellationToken,
... parameters : Object[]
) : Task<int>
參數
- sql
類型:System.String
命令字串。
- cancellationToken
類型:System.Threading.CancellationToken
等候工作完成時要觀察的 CancellationToken。
- parameters
類型:System.Object[]
要套用至命令字串的參數。
傳回值
類型:System.Threading.Tasks.Task<Int32>
表示非同步作業的工作。工作結果包含執行此命令之後由資料庫傳回的結果。
備註
不支援相同內容執行個體上的多個作用中作業。 使用 'await' 確保在此內容上呼叫另一個方法之前,所有非同步作業都已完成。 如果沒有現存的本機交易,則會使用新的交易來執行命令。