共用方式為


ObjectContext.ExecuteStoreCommandAsync 方法 (TransactionalBehavior, String, CancellationToken, Object[])

[此頁面專屬於 Entity Framework 第 6 版。最新版本可從 'Entity Framework' NuGet 套件取得。如需 Entity Framework 的詳細資訊,請參閱 msdn.com/data/ef。]

使用現有的連接,以非同步方式直接針對資料來源執行任意命令。 此命令是使用伺服器的原生查詢語言 (例如 SQL) 指定。 如同所有接受 SQL 的應用程式開發介面,任何使用者輸入都務必進行參數化以防範 SQL 插入式攻擊。 您可在 SQL 查詢字串中加入參數預留位置,然後再以其他引數提供參數值。 您所提供的任何參數值都將自動轉換為 DbParameter。 context.ExecuteStoreCommandAsync("UPDATE dbo.Posts SET Rating = 5 WHERE Author = @p0", userSuppliedAuthor)。或者,您也可以建構 DbParameter 再將其提供給 SqlQuery。 如此您便能在 SQL 查詢字串中使用具名參數。 context.ExecuteStoreCommandAsync("UPDATE dbo.Posts SET Rating = 5 WHERE Author = @author", new SqlParameter("@author", userSuppliedAuthor))。

命名空間:  System.Data.Entity.Core.Objects
組件:  EntityFramework (在 EntityFramework.dll 中)

語法

'宣告
Public Overridable Function ExecuteStoreCommandAsync ( _
    transactionalBehavior As TransactionalBehavior, _
    commandText As String, _
    cancellationToken As CancellationToken, _
    ParamArray parameters As Object() _
) As Task(Of Integer)
'用途
Dim instance As ObjectContext 
Dim transactionalBehavior As TransactionalBehavior 
Dim commandText As String 
Dim cancellationToken As CancellationToken 
Dim parameters As Object()
Dim returnValue As Task(Of Integer)

returnValue = instance.ExecuteStoreCommandAsync(transactionalBehavior, _
    commandText, cancellationToken, _
    parameters)
public virtual Task<int> ExecuteStoreCommandAsync(
    TransactionalBehavior transactionalBehavior,
    string commandText,
    CancellationToken cancellationToken,
    params Object[] parameters
)
public:
virtual Task<int>^ ExecuteStoreCommandAsync(
    TransactionalBehavior transactionalBehavior, 
    String^ commandText, 
    CancellationToken cancellationToken, 
    ... array<Object^>^ parameters
)
abstract ExecuteStoreCommandAsync : 
        transactionalBehavior:TransactionalBehavior * 
        commandText:string * 
        cancellationToken:CancellationToken * 
        parameters:Object[] -> Task<int> 
override ExecuteStoreCommandAsync : 
        transactionalBehavior:TransactionalBehavior * 
        commandText:string * 
        cancellationToken:CancellationToken * 
        parameters:Object[] -> Task<int> 
public function ExecuteStoreCommandAsync(
    transactionalBehavior : TransactionalBehavior, 
    commandText : String, 
    cancellationToken : CancellationToken, 
    ... parameters : Object[]
) : Task<int>

參數

  • commandText
    類型:System.String
    使用伺服器的原生查詢語言指定的命令。
  • parameters
    類型:System.Object[]
    要用於查詢的參數值。

傳回值

類型:System.Threading.Tasks.Task<Int32>
表示非同步作業的工作。工作結果包含受影響的資料列數。

備註

不支援相同內容執行個體上的多個作用中作業。 使用 'await' 確保在此內容上呼叫另一個方法之前,所有非同步作業都已完成。

請參閱

參考

ObjectContext 類別

ExecuteStoreCommandAsync 多載

System.Data.Entity.Core.Objects 命名空間