RelationalDatabaseFacadeExtensions.ExecuteSqlCommandAsync 方法

定义

命名空间:

Microsoft.EntityFrameworkCore

程序集:

Microsoft.EntityFrameworkCore.Relational.dll

程序包:

Microsoft.EntityFrameworkCore.Relational v3.1.0

重载

名称	说明
ExecuteSqlCommandAsync(DatabaseFacade, RawSqlString, IEnumerable<Object>, CancellationToken)	已过时. 针对数据库执行给定的 SQL，并返回受影响的行数。 请注意，此方法不会启动事务。 若要将此方法与事务一起使用，请首先调用 BeginTransaction(DatabaseFacade, IsolationLevel) 或 UseTransaction(DatabaseFacade, DbTransaction)。 请注意，此方法不使用当前 ExecutionStrategy 值，因为 SQL 可能不是幂等的，也不会在事务中运行。 可以显式使用 ExecutionStrategy，确保在 SQL 不是幂等的情况下也使用事务。 与接受 SQL 的任何 API 一样，必须参数化任何用户输入以防止 SQL 注入攻击。 可以在 SQL 查询字符串中包含参数位置持有者，然后将参数值作为其他参数提供。 你提供的任何参数值将自动转换为 DbParameter。 还可以考虑使用 ExecuteSqlInterpolated 来使用内插字符串语法来创建参数。
ExecuteSqlCommandAsync(DatabaseFacade, RawSqlString, CancellationToken)	已过时. 针对数据库执行给定的 SQL，并返回受影响的行数。 请注意，此方法不会启动事务。 若要将此方法与事务一起使用，请首先调用 BeginTransaction(DatabaseFacade, IsolationLevel) 或 UseTransaction(DatabaseFacade, DbTransaction)。 请注意，此方法不使用当前 ExecutionStrategy 值，因为 SQL 可能不是幂等的，也不会在事务中运行。 可以显式使用 ExecutionStrategy，确保在 SQL 不是幂等的情况下也使用事务。 与接受 SQL 的任何 API 一样，必须参数化任何用户输入以防止 SQL 注入攻击。 可以在 SQL 查询字符串中包含参数位置持有者，然后将参数值作为其他参数提供。 你提供的任何参数值将自动转换为 DbParameter - context.Database.ExecuteSqlCommandAsync("SELECT * FROM [dbo].[SearchBlogs]({0})", userSuppliedSearchTerm)。
ExecuteSqlCommandAsync(DatabaseFacade, RawSqlString, Object[])	已过时. 针对数据库执行给定的 SQL，并返回受影响的行数。 请注意，此方法不会启动事务。 若要将此方法与事务一起使用，请首先调用 BeginTransaction(DatabaseFacade, IsolationLevel) 或 UseTransaction(DatabaseFacade, DbTransaction)。 请注意，此方法不使用当前 ExecutionStrategy 值，因为 SQL 可能不是幂等的，也不会在事务中运行。 可以显式使用 ExecutionStrategy，确保在 SQL 不是幂等的情况下也使用事务。 与接受 SQL 的任何 API 一样，必须参数化任何用户输入以防止 SQL 注入攻击。 可以在 SQL 查询字符串中包含参数位置持有者，然后将参数值作为其他参数提供。 你提供的任何参数值将自动转换为 DbParameter - context.Database.ExecuteSqlCommandAsync("SELECT * FROM [dbo].[SearchBlogs]({0})", userSuppliedSearchTerm)。 还可以考虑使用 ExecuteSqlInterpolated 来使用内插字符串语法来创建参数。
ExecuteSqlCommandAsync(DatabaseFacade, FormattableString, CancellationToken)	已过时. 针对数据库执行给定的 SQL，并返回受影响的行数。 请注意，此方法不会启动事务。 若要将此方法与事务一起使用，请首先调用 BeginTransaction(DatabaseFacade, IsolationLevel) 或 UseTransaction(DatabaseFacade, DbTransaction)。 请注意，此方法不使用当前 ExecutionStrategy 值，因为 SQL 可能不是幂等的，也不会在事务中运行。 可以显式使用 ExecutionStrategy，确保在 SQL 不是幂等的情况下也使用事务。 与接受 SQL 的任何 API 一样，必须参数化任何用户输入以防止 SQL 注入攻击。 可以在 SQL 查询字符串中包含参数位置持有者，然后将参数值作为其他参数提供。 你提供的任何参数值将自动转换为 DbParameter - context.Database.ExecuteSqlCommandAsync($"SELECT * FROM [dbo].[SearchBlogs]({userSuppliedSearchTerm})")。

ExecuteSqlCommandAsync(DatabaseFacade, RawSqlString, IEnumerable<Object>, CancellationToken)

Source:

RelationalDatabaseFacadeExtensions.cs

注意

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)。

请注意，此方法不使用当前 ExecutionStrategy 值，因为 SQL 可能不是幂等的，也不会在事务中运行。 可以显式使用 ExecutionStrategy，确保在 SQL 不是幂等的情况下也使用事务。

与接受 SQL 的任何 API 一样，必须参数化任何用户输入以防止 SQL 注入攻击。 可以在 SQL 查询字符串中包含参数位置持有者，然后将参数值作为其他参数提供。 你提供的任何参数值将自动转换为 DbParameter。 还可以考虑使用 ExecuteSqlInterpolated 来使用内插字符串语法来创建参数。

[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);

[<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

等待任务完成时观察的 A CancellationToken 。

返回

Task<Int32>

表示异步操作的任务。 任务结果是受影响的行数。

特性

ObsoleteAttribute

ExecuteSqlCommandAsync(DatabaseFacade, RawSqlString, CancellationToken)

Source:

RelationalDatabaseFacadeExtensions.cs

注意

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)。

请注意，此方法不使用当前 ExecutionStrategy 值，因为 SQL 可能不是幂等的，也不会在事务中运行。 可以显式使用 ExecutionStrategy，确保在 SQL 不是幂等的情况下也使用事务。

与接受 SQL 的任何 API 一样，必须参数化任何用户输入以防止 SQL 注入攻击。 可以在 SQL 查询字符串中包含参数位置持有者，然后将参数值作为其他参数提供。 你提供的任何参数值将自动转换为 DbParameter - context.Database.ExecuteSqlCommandAsync("SELECT * FROM [dbo].[SearchBlogs]({0})", userSuppliedSearchTerm)。

[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);

[<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

等待任务完成时观察的 A CancellationToken 。

返回

Task<Int32>

表示异步操作的任务。 任务结果是受影响的行数。

特性

ObsoleteAttribute

ExecuteSqlCommandAsync(DatabaseFacade, RawSqlString, Object[])

Source:

RelationalDatabaseFacadeExtensions.cs

注意

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)。

请注意，此方法不使用当前 ExecutionStrategy 值，因为 SQL 可能不是幂等的，也不会在事务中运行。 可以显式使用 ExecutionStrategy，确保在 SQL 不是幂等的情况下也使用事务。

与接受 SQL 的任何 API 一样，必须参数化任何用户输入以防止 SQL 注入攻击。 可以在 SQL 查询字符串中包含参数位置持有者，然后将参数值作为其他参数提供。 你提供的任何参数值将自动转换为 DbParameter - context.Database.ExecuteSqlCommandAsync("SELECT * FROM [dbo].[SearchBlogs]({0})", userSuppliedSearchTerm)。 还可以考虑使用 ExecuteSqlInterpolated 来使用内插字符串语法来创建参数。

[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);

[<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 的参数。

返回

Task<Int32>

表示异步操作的任务。 任务结果是受影响的行数。

特性

ObsoleteAttribute

ExecuteSqlCommandAsync(DatabaseFacade, FormattableString, CancellationToken)

Source:

RelationalDatabaseFacadeExtensions.cs

注意

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)。

请注意，此方法不使用当前 ExecutionStrategy 值，因为 SQL 可能不是幂等的，也不会在事务中运行。 可以显式使用 ExecutionStrategy，确保在 SQL 不是幂等的情况下也使用事务。

与接受 SQL 的任何 API 一样，必须参数化任何用户输入以防止 SQL 注入攻击。 可以在 SQL 查询字符串中包含参数位置持有者，然后将参数值作为其他参数提供。 你提供的任何参数值将自动转换为 DbParameter - context.Database.ExecuteSqlCommandAsync($"SELECT * FROM [dbo].[SearchBlogs]({userSuppliedSearchTerm})")。

[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);

[<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

FormattableString

表示具有参数的 SQL 查询的内插字符串。

cancellationToken

CancellationToken

等待任务完成时观察的 A CancellationToken 。

返回

Task<Int32>

表示异步操作的任务。 任务结果是受影响的行数。

特性

ObsoleteAttribute