RelationalDatabaseFacadeExtensions.ExecuteSqlInterpolatedAsync 方法

public static System.Threading.Tasks.Task<int> ExecuteSqlInterpolatedAsync(this Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade databaseFacade, FormattableString sql, System.Threading.CancellationToken cancellationToken = default);

[System.Obsolete("Use ExecuteSqlAsync() instead. This method is obsolete and will be removed in a future release.")]
public static System.Threading.Tasks.Task<int> ExecuteSqlInterpolatedAsync(this Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade databaseFacade, FormattableString sql, System.Threading.CancellationToken cancellationToken = default);

static member ExecuteSqlInterpolatedAsync : Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade * FormattableString * System.Threading.CancellationToken -> System.Threading.Tasks.Task<int>

[<System.Obsolete("Use ExecuteSqlAsync() instead. This method is obsolete and will be removed in a future release.")>]
static member ExecuteSqlInterpolatedAsync : Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade * FormattableString * System.Threading.CancellationToken -> System.Threading.Tasks.Task<int>

<Extension()>
Public Function ExecuteSqlInterpolatedAsync (databaseFacade As DatabaseFacade, sql As FormattableString, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Integer)

參數

傳回

一個代表非同步操作的任務。 任務結果即為受影響的列數。

屬性

ObsoleteAttribute

例外狀況

備註

請注意，此方法不會啟動交易。 若要使用此方法處理交易，首先呼叫 BeginTransaction(DatabaseFacade, IsolationLevel) 或 UseTransaction。

請注意，此方法不使用當前 ExecutionStrategy 值，因為 SQL 可能不是冪등元，且不在交易中執行。 An ExecutionStrategy 可以明確使用，若 SQL 非冪등 式，請確保同時使用交易。

和任何接受 SQL 的 API 一樣，必須對使用者輸入進行參數化，以防止 SQL 注入攻擊。 你可以在 SQL 查詢字串中加入參數佔位符，然後以參數值作為額外參數。 你提供的任何參數值都會自動轉換成 DbParameter。

更多資訊與範例請參閱「 使用 EF Core 執行原始 SQL 指令 」。