RelationalDatabaseFacadeExtensions.ExecuteSqlCommandAsync メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
| Name | 説明 |
|---|---|
| ExecuteSqlCommandAsync(DatabaseFacade, String, CancellationToken, Object[]) | |
| ExecuteSqlCommandAsync(DatabaseFacade, RawSqlString, IEnumerable<Object>, CancellationToken) |
古い.
データベースに対して指定された SQL を実行し、影響を受けた行数を返します。 このメソッドはトランザクションを開始しないことに注意してください。 トランザクションでこのメソッドを使用するには、最初に BeginTransaction(DatabaseFacade, IsolationLevel) または UseTransaction(DatabaseFacade, DbTransaction)を呼び出します。 SQL はべき等ではなく、トランザクションで実行されない可能性があるため、現在の ExecutionStrategy はこのメソッドでは使用されないことに注意してください。 ExecutionStrategy は明示的に使用できるため、SQL がべき等でない場合もトランザクションを使用してください。 SQL を受け入れる API と同様に、SQL インジェクション攻撃から保護するためにユーザー入力をパラメーター化することが重要です。 SQL クエリ文字列にパラメーターのプレース ホルダーを含め、パラメーター値を追加の引数として指定できます。 指定したパラメーター値は、自動的に DbParameter に変換されます。 ExecuteSqlInterpolated を使用して補間文字列構文を使用してパラメーターを作成することも検討できます。 |
| ExecuteSqlCommandAsync(DatabaseFacade, RawSqlString, CancellationToken) |
古い.
データベースに対して指定された SQL を実行し、影響を受けた行数を返します。 このメソッドはトランザクションを開始しないことに注意してください。 トランザクションでこのメソッドを使用するには、最初に BeginTransaction(DatabaseFacade, IsolationLevel) または UseTransaction(DatabaseFacade, DbTransaction)を呼び出します。 SQL はべき等ではなく、トランザクションで実行されない可能性があるため、現在の ExecutionStrategy はこのメソッドでは使用されないことに注意してください。 ExecutionStrategy は明示的に使用できるため、SQL がべき等でない場合もトランザクションを使用してください。
SQL を受け入れる API と同様に、SQL インジェクション攻撃から保護するためにユーザー入力をパラメーター化することが重要です。 SQL クエリ文字列にパラメーターのプレース ホルダーを含め、パラメーター値を追加の引数として指定できます。 指定したパラメーター値は、自動的に DbParameter - |
| ExecuteSqlCommandAsync(DatabaseFacade, RawSqlString, Object[]) |
古い.
データベースに対して指定された SQL を実行し、影響を受けた行数を返します。 このメソッドはトランザクションを開始しないことに注意してください。 トランザクションでこのメソッドを使用するには、最初に BeginTransaction(DatabaseFacade, IsolationLevel) または UseTransaction(DatabaseFacade, DbTransaction)を呼び出します。 SQL はべき等ではなく、トランザクションで実行されない可能性があるため、現在の ExecutionStrategy はこのメソッドでは使用されないことに注意してください。 ExecutionStrategy は明示的に使用できるため、SQL がべき等でない場合もトランザクションを使用してください。
SQL を受け入れる API と同様に、SQL インジェクション攻撃から保護するためにユーザー入力をパラメーター化することが重要です。 SQL クエリ文字列にパラメーターのプレース ホルダーを含め、パラメーター値を追加の引数として指定できます。 指定したパラメーター値は、自動的に DbParameter - |
| ExecuteSqlCommandAsync(DatabaseFacade, FormattableString, CancellationToken) |
古い.
データベースに対して指定された SQL を実行し、影響を受けた行数を返します。 このメソッドはトランザクションを開始しないことに注意してください。 トランザクションでこのメソッドを使用するには、最初に BeginTransaction(DatabaseFacade, IsolationLevel) または UseTransaction(DatabaseFacade, DbTransaction)を呼び出します。 SQL はべき等ではなく、トランザクションで実行されない可能性があるため、現在の ExecutionStrategy はこのメソッドでは使用されないことに注意してください。 ExecutionStrategy は明示的に使用できるため、SQL がべき等でない場合もトランザクションを使用してください。
SQL を受け入れる API と同様に、SQL インジェクション攻撃から保護するためにユーザー入力をパラメーター化することが重要です。 SQL クエリ文字列にパラメーターのプレース ホルダーを含め、パラメーター値を追加の引数として指定できます。 指定したパラメーター値は、自動的に DbParameter - |
ExecuteSqlCommandAsync(DatabaseFacade, String, CancellationToken, Object[])
public static System.Threading.Tasks.Task<int> ExecuteSqlCommandAsync(this Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade databaseFacade, string sql, System.Threading.CancellationToken cancellationToken = default, params object[] parameters);static member ExecuteSqlCommandAsync : Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade * string * System.Threading.CancellationToken * obj[] -> System.Threading.Tasks.Task<int><Extension()>
Public Function ExecuteSqlCommandAsync (databaseFacade As DatabaseFacade, sql As String, Optional cancellationToken As CancellationToken = Nothing, ParamArray parameters As Object()) As Task(Of Integer)パラメーター
- databaseFacade
- DatabaseFacade
- sql
- String
- cancellationToken
- CancellationToken
- parameters
- Object[]
戻り値
適用対象
ExecuteSqlCommandAsync(DatabaseFacade, RawSqlString, IEnumerable<Object>, CancellationToken)
注意事項
For the async execution of SQL queries using plain strings, use ExecuteSqlRawAsync instead. For the async execution of SQL queries using interpolated string syntax to create parameters, use ExecuteSqlInterpolatedAsync instead.
データベースに対して指定された SQL を実行し、影響を受けた行数を返します。
このメソッドはトランザクションを開始しないことに注意してください。 トランザクションでこのメソッドを使用するには、最初に BeginTransaction(DatabaseFacade, IsolationLevel) または UseTransaction(DatabaseFacade, DbTransaction)を呼び出します。
SQL はべき等ではなく、トランザクションで実行されない可能性があるため、現在の ExecutionStrategy はこのメソッドでは使用されないことに注意してください。 ExecutionStrategy は明示的に使用できるため、SQL がべき等でない場合もトランザクションを使用してください。
SQL を受け入れる API と同様に、SQL インジェクション攻撃から保護するためにユーザー入力をパラメーター化することが重要です。 SQL クエリ文字列にパラメーターのプレース ホルダーを含め、パラメーター値を追加の引数として指定できます。 指定したパラメーター値は、自動的に DbParameter に変換されます。 ExecuteSqlInterpolated を使用して補間文字列構文を使用してパラメーターを作成することも検討できます。
public static System.Threading.Tasks.Task<int> ExecuteSqlCommandAsync(this Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade databaseFacade, Microsoft.EntityFrameworkCore.RawSqlString sql, System.Collections.Generic.IEnumerable<object> parameters, System.Threading.CancellationToken cancellationToken = default);[System.Obsolete("For the async execution of SQL queries using plain strings, use ExecuteSqlRawAsync instead. For the async execution of SQL queries using interpolated string syntax to create parameters, use ExecuteSqlInterpolatedAsync instead.")]
public static System.Threading.Tasks.Task<int> ExecuteSqlCommandAsync(this Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade databaseFacade, Microsoft.EntityFrameworkCore.RawSqlString sql, System.Collections.Generic.IEnumerable<object> parameters, System.Threading.CancellationToken cancellationToken = default);static member ExecuteSqlCommandAsync : Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade * Microsoft.EntityFrameworkCore.RawSqlString * seq<obj> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<int>[<System.Obsolete("For the async execution of SQL queries using plain strings, use ExecuteSqlRawAsync instead. For the async execution of SQL queries using interpolated string syntax to create parameters, use ExecuteSqlInterpolatedAsync instead.")>]
static member ExecuteSqlCommandAsync : Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade * Microsoft.EntityFrameworkCore.RawSqlString * seq<obj> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<int><Extension()>
Public Function ExecuteSqlCommandAsync (databaseFacade As DatabaseFacade, sql As RawSqlString, parameters As IEnumerable(Of Object), Optional cancellationToken As CancellationToken = Nothing) As Task(Of Integer)パラメーター
- databaseFacade
- DatabaseFacade
コンテキストの DatabaseFacade 。
- sql
- RawSqlString
実行する SQL。
- parameters
- IEnumerable<Object>
SQL で使用するパラメーター。
- cancellationToken
- CancellationToken
タスクの完了を待機している間に観察する CancellationToken 。
戻り値
非同期操作を表すタスク。 タスクの結果は、影響を受ける行の数です。
- 属性
適用対象
ExecuteSqlCommandAsync(DatabaseFacade, RawSqlString, CancellationToken)
注意事項
For the async execution of SQL queries using plain strings, use ExecuteSqlRawAsync instead. For the async execution of SQL queries using interpolated string syntax to create parameters, use ExecuteSqlInterpolatedAsync instead.
データベースに対して指定された SQL を実行し、影響を受けた行数を返します。
このメソッドはトランザクションを開始しないことに注意してください。 トランザクションでこのメソッドを使用するには、最初に BeginTransaction(DatabaseFacade, IsolationLevel) または UseTransaction(DatabaseFacade, DbTransaction)を呼び出します。
SQL はべき等ではなく、トランザクションで実行されない可能性があるため、現在の ExecutionStrategy はこのメソッドでは使用されないことに注意してください。 ExecutionStrategy は明示的に使用できるため、SQL がべき等でない場合もトランザクションを使用してください。
SQL を受け入れる API と同様に、SQL インジェクション攻撃から保護するためにユーザー入力をパラメーター化することが重要です。 SQL クエリ文字列にパラメーターのプレース ホルダーを含め、パラメーター値を追加の引数として指定できます。 指定したパラメーター値は、自動的に DbParameter - context.Database.ExecuteSqlCommandAsync("SELECT * FROM [dbo].[SearchBlogs]({0})", userSuppliedSearchTerm)に変換されます。
public static System.Threading.Tasks.Task<int> ExecuteSqlCommandAsync(this Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade databaseFacade, Microsoft.EntityFrameworkCore.RawSqlString sql, System.Threading.CancellationToken cancellationToken = default);[System.Obsolete("For the async execution of SQL queries using plain strings, use ExecuteSqlRawAsync instead. For the async execution of SQL queries using interpolated string syntax to create parameters, use ExecuteSqlInterpolatedAsync instead.")]
public static System.Threading.Tasks.Task<int> ExecuteSqlCommandAsync(this Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade databaseFacade, Microsoft.EntityFrameworkCore.RawSqlString sql, System.Threading.CancellationToken cancellationToken = default);static member ExecuteSqlCommandAsync : Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade * Microsoft.EntityFrameworkCore.RawSqlString * System.Threading.CancellationToken -> System.Threading.Tasks.Task<int>[<System.Obsolete("For the async execution of SQL queries using plain strings, use ExecuteSqlRawAsync instead. For the async execution of SQL queries using interpolated string syntax to create parameters, use ExecuteSqlInterpolatedAsync instead.")>]
static member ExecuteSqlCommandAsync : Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade * Microsoft.EntityFrameworkCore.RawSqlString * System.Threading.CancellationToken -> System.Threading.Tasks.Task<int><Extension()>
Public Function ExecuteSqlCommandAsync (databaseFacade As DatabaseFacade, sql As RawSqlString, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Integer)パラメーター
- databaseFacade
- DatabaseFacade
コンテキストの DatabaseFacade 。
- sql
- RawSqlString
実行する SQL。
- cancellationToken
- CancellationToken
タスクの完了を待機している間に観察する CancellationToken 。
戻り値
非同期操作を表すタスク。 タスクの結果は、影響を受ける行の数です。
- 属性
適用対象
ExecuteSqlCommandAsync(DatabaseFacade, RawSqlString, Object[])
注意事項
For the async execution of SQL queries using plain strings, use ExecuteSqlRawAsync instead. For the async execution of SQL queries using interpolated string syntax to create parameters, use ExecuteSqlInterpolatedAsync instead.
データベースに対して指定された SQL を実行し、影響を受けた行数を返します。
このメソッドはトランザクションを開始しないことに注意してください。 トランザクションでこのメソッドを使用するには、最初に BeginTransaction(DatabaseFacade, IsolationLevel) または UseTransaction(DatabaseFacade, DbTransaction)を呼び出します。
SQL はべき等ではなく、トランザクションで実行されない可能性があるため、現在の ExecutionStrategy はこのメソッドでは使用されないことに注意してください。 ExecutionStrategy は明示的に使用できるため、SQL がべき等でない場合もトランザクションを使用してください。
SQL を受け入れる API と同様に、SQL インジェクション攻撃から保護するためにユーザー入力をパラメーター化することが重要です。 SQL クエリ文字列にパラメーターのプレース ホルダーを含め、パラメーター値を追加の引数として指定できます。 指定したパラメーター値は、自動的に DbParameter - context.Database.ExecuteSqlCommandAsync("SELECT * FROM [dbo].[SearchBlogs]({0})", userSuppliedSearchTerm)に変換されます。
ExecuteSqlInterpolated を使用して補間文字列構文を使用してパラメーターを作成することも検討できます。
public static System.Threading.Tasks.Task<int> ExecuteSqlCommandAsync(this Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade databaseFacade, Microsoft.EntityFrameworkCore.RawSqlString sql, params object[] parameters);[System.Obsolete("For the async execution of SQL queries using plain strings, use ExecuteSqlRawAsync instead. For the async execution of SQL queries using interpolated string syntax to create parameters, use ExecuteSqlInterpolatedAsync instead.")]
public static System.Threading.Tasks.Task<int> ExecuteSqlCommandAsync(this Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade databaseFacade, Microsoft.EntityFrameworkCore.RawSqlString sql, params object[] parameters);static member ExecuteSqlCommandAsync : Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade * Microsoft.EntityFrameworkCore.RawSqlString * obj[] -> System.Threading.Tasks.Task<int>[<System.Obsolete("For the async execution of SQL queries using plain strings, use ExecuteSqlRawAsync instead. For the async execution of SQL queries using interpolated string syntax to create parameters, use ExecuteSqlInterpolatedAsync instead.")>]
static member ExecuteSqlCommandAsync : Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade * Microsoft.EntityFrameworkCore.RawSqlString * obj[] -> System.Threading.Tasks.Task<int><Extension()>
Public Function ExecuteSqlCommandAsync (databaseFacade As DatabaseFacade, sql As RawSqlString, ParamArray parameters As Object()) As Task(Of Integer)パラメーター
- databaseFacade
- DatabaseFacade
コンテキストの DatabaseFacade 。
- sql
- RawSqlString
実行する SQL。
- parameters
- Object[]
SQL で使用するパラメーター。
戻り値
非同期操作を表すタスク。 タスクの結果は、影響を受ける行の数です。
- 属性
適用対象
ExecuteSqlCommandAsync(DatabaseFacade, FormattableString, CancellationToken)
注意事項
For the async execution of SQL queries using plain strings, use ExecuteSqlRawAsync instead. For the async execution of SQL queries using interpolated string syntax to create parameters, use ExecuteSqlInterpolatedAsync instead.
データベースに対して指定された SQL を実行し、影響を受けた行数を返します。
このメソッドはトランザクションを開始しないことに注意してください。 トランザクションでこのメソッドを使用するには、最初に BeginTransaction(DatabaseFacade, IsolationLevel) または UseTransaction(DatabaseFacade, DbTransaction)を呼び出します。
SQL はべき等ではなく、トランザクションで実行されない可能性があるため、現在の ExecutionStrategy はこのメソッドでは使用されないことに注意してください。 ExecutionStrategy は明示的に使用できるため、SQL がべき等でない場合もトランザクションを使用してください。
SQL を受け入れる API と同様に、SQL インジェクション攻撃から保護するためにユーザー入力をパラメーター化することが重要です。 SQL クエリ文字列にパラメーターのプレース ホルダーを含め、パラメーター値を追加の引数として指定できます。 指定したパラメーター値は、自動的に DbParameter - context.Database.ExecuteSqlCommandAsync($"SELECT * FROM [dbo].[SearchBlogs]({userSuppliedSearchTerm})")に変換されます。
public static System.Threading.Tasks.Task<int> ExecuteSqlCommandAsync(this Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade databaseFacade, FormattableString sql, System.Threading.CancellationToken cancellationToken = default);[System.Obsolete("For the async execution of SQL queries using plain strings, use ExecuteSqlRawAsync instead. For the async execution of SQL queries using interpolated string syntax to create parameters, use ExecuteSqlInterpolatedAsync instead.")]
public static System.Threading.Tasks.Task<int> ExecuteSqlCommandAsync(this Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade databaseFacade, FormattableString sql, System.Threading.CancellationToken cancellationToken = default);static member ExecuteSqlCommandAsync : Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade * FormattableString * System.Threading.CancellationToken -> System.Threading.Tasks.Task<int>[<System.Obsolete("For the async execution of SQL queries using plain strings, use ExecuteSqlRawAsync instead. For the async execution of SQL queries using interpolated string syntax to create parameters, use ExecuteSqlInterpolatedAsync instead.")>]
static member ExecuteSqlCommandAsync : Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade * FormattableString * System.Threading.CancellationToken -> System.Threading.Tasks.Task<int><Extension()>
Public Function ExecuteSqlCommandAsync (databaseFacade As DatabaseFacade, sql As FormattableString, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Integer)パラメーター
- databaseFacade
- DatabaseFacade
コンテキストの DatabaseFacade 。
パラメーターを含む SQL クエリを表す挿入文字列。
- cancellationToken
- CancellationToken
タスクの完了を待機している間に観察する CancellationToken 。
戻り値
非同期操作を表すタスク。 タスクの結果は、影響を受ける行の数です。
- 属性
