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

等待 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

等待 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

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

返回

Task<Int32>

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

属性

ObsoleteAttribute