Language

RelationalDatabaseFacadeExtensions.ExecuteSqlInterpolated メソッド

定義

注意事項

Use ExecuteSql() instead. This method is obsolete and will be removed in a future release.

データベースに対して指定された SQL を実行し、影響を受けた行数を返します。

public static int ExecuteSqlInterpolated(this Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade databaseFacade, FormattableString sql);
[System.Obsolete("Use ExecuteSql() instead. This method is obsolete and will be removed in a future release.")]
public static int ExecuteSqlInterpolated(this Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade databaseFacade, FormattableString sql);
static member ExecuteSqlInterpolated : Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade * FormattableString -> int
[<System.Obsolete("Use ExecuteSql() instead. This method is obsolete and will be removed in a future release.")>]
static member ExecuteSqlInterpolated : Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade * FormattableString -> int
<Extension()>
Public Function ExecuteSqlInterpolated (databaseFacade As DatabaseFacade, sql As FormattableString) As Integer

パラメーター

databaseFacade
DatabaseFacade

コンテキストの DatabaseFacade 。

sql
FormattableString

パラメーターを含む SQL クエリを表す挿入文字列。

戻り値

影響を受ける行の数。

属性

注釈

このメソッドはトランザクションを開始しないことに注意してください。 トランザクションでこのメソッドを使用するには、最初に BeginTransaction(DatabaseFacade, IsolationLevel) または UseTransactionを呼び出します。

SQL はべき等ではなく、トランザクションで実行されない可能性があるため、現在の ExecutionStrategy はこのメソッドでは使用されないことに注意してください。 ExecutionStrategyは明示的に使用できるため、SQL がべき等でない場合もトランザクションを使用するようにしてください。

SQL を受け入れる API と同様に、SQL インジェクション攻撃から保護するためにユーザー入力をパラメーター化することが重要です。 SQL クエリ文字列にパラメーターのプレース ホルダーを含め、パラメーター値を追加の引数として指定できます。 指定したパラメーター値は、自動的に DbParameter に変換されます。

詳細と例については、 EF Core を使用した生 SQL コマンドの実行 を参照してください。

適用対象