RelationalDatabaseFacadeExtensions.ExecuteSqlRawAsync Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перегрузки
| Имя. | Описание |
|---|---|
| ExecuteSqlRawAsync(DatabaseFacade, String, Object[]) |
Выполняет заданный SQL для базы данных и возвращает количество затронутых строк. |
| ExecuteSqlRawAsync(DatabaseFacade, String, CancellationToken) |
Выполняет заданный SQL для базы данных и возвращает количество затронутых строк. |
| ExecuteSqlRawAsync(DatabaseFacade, String, IEnumerable<Object>, CancellationToken) |
Выполняет заданный SQL для базы данных и возвращает количество затронутых строк. |
ExecuteSqlRawAsync(DatabaseFacade, String, Object[])
- Исходный код:
- RelationalDatabaseFacadeExtensions.cs
- Исходный код:
- RelationalDatabaseFacadeExtensions.cs
- Исходный код:
- RelationalDatabaseFacadeExtensions.cs
- Исходный код:
- RelationalDatabaseFacadeExtensions.cs
- Исходный код:
- RelationalDatabaseFacadeExtensions.cs
- Исходный код:
- RelationalDatabaseFacadeExtensions.cs
- Исходный код:
- RelationalDatabaseFacadeExtensions.cs
- Исходный код:
- RelationalDatabaseFacadeExtensions.cs
- Исходный код:
- RelationalDatabaseFacadeExtensions.cs
Выполняет заданный SQL для базы данных и возвращает количество затронутых строк.
public static System.Threading.Tasks.Task<int> ExecuteSqlRawAsync(this Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade databaseFacade, string sql, params object[] parameters);
public static System.Threading.Tasks.Task<int> ExecuteSqlRawAsync(this Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade databaseFacade, string sql, params object?[] parameters);
static member ExecuteSqlRawAsync : Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade * string * obj[] -> System.Threading.Tasks.Task<int>
<Extension()>
Public Function ExecuteSqlRawAsync (databaseFacade As DatabaseFacade, sql As String, ParamArray parameters As Object()) As Task(Of Integer)
Параметры
- databaseFacade
- DatabaseFacade
Контекст DatabaseFacade .
- sql
- String
SQL для выполнения.
- parameters
- Object[]
Параметры для использования с SQL.
Возвращаемое значение
Задача, представляющая асинхронную операцию. Результатом задачи является количество затронутых строк.
Комментарии
Обратите внимание, что этот метод не запускает транзакцию. Чтобы использовать этот метод с транзакцией, сначала вызовите BeginTransaction(DatabaseFacade, IsolationLevel) или UseTransaction.
Обратите внимание, что текущий ExecutionStrategy метод не используется этим методом, так как SQL не может быть идемпотентным и не выполняется в транзакции. Можно ExecutionStrategy использовать явно, не забудьте также использовать транзакцию, если SQL не является идемпотентным.
Как и в случае с любым API, принимающего SQL, важно параметризовать любые входные данные пользователя для защиты от атаки внедрения SQL. Можно включить держатели параметров в строку запроса SQL, а затем указать значения параметров в качестве дополнительных аргументов. Все указанные значения параметров автоматически преобразуются в DbParameter.
Однако никогда не передайте в этот метод сцепленную или интерполированную строку ($"") с не проверенными значениями, предоставленными пользователем. Это может привести к атакам внедрения приложений SQL. Чтобы использовать интерполированный синтаксис строки, рекомендуется использовать для ExecuteSqlAsync(DatabaseFacade, FormattableString, CancellationToken) создания параметров.
Дополнительные сведения и примеры см. в разделе "Выполнение необработанных команд SQL с помощью EF Core ".
Применяется к
ExecuteSqlRawAsync(DatabaseFacade, String, CancellationToken)
- Исходный код:
- RelationalDatabaseFacadeExtensions.cs
- Исходный код:
- RelationalDatabaseFacadeExtensions.cs
- Исходный код:
- RelationalDatabaseFacadeExtensions.cs
- Исходный код:
- RelationalDatabaseFacadeExtensions.cs
- Исходный код:
- RelationalDatabaseFacadeExtensions.cs
- Исходный код:
- RelationalDatabaseFacadeExtensions.cs
- Исходный код:
- RelationalDatabaseFacadeExtensions.cs
- Исходный код:
- RelationalDatabaseFacadeExtensions.cs
- Исходный код:
- RelationalDatabaseFacadeExtensions.cs
Выполняет заданный SQL для базы данных и возвращает количество затронутых строк.
public static System.Threading.Tasks.Task<int> ExecuteSqlRawAsync(this Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade databaseFacade, string sql, System.Threading.CancellationToken cancellationToken = default);
static member ExecuteSqlRawAsync : Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<int>
<Extension()>
Public Function ExecuteSqlRawAsync (databaseFacade As DatabaseFacade, sql As String, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Integer)
Параметры
- databaseFacade
- DatabaseFacade
Контекст DatabaseFacade .
- sql
- String
SQL для выполнения.
- cancellationToken
- CancellationToken
Необходимо CancellationToken наблюдать за ожиданием завершения задачи.
Возвращаемое значение
Задача, представляющая асинхронную операцию. Результатом задачи является количество затронутых строк.
Исключения
Если отменяется CancellationToken .
Комментарии
Обратите внимание, что этот метод не запускает транзакцию. Чтобы использовать этот метод с транзакцией, сначала вызовите BeginTransaction(DatabaseFacade, IsolationLevel) или UseTransaction.
Обратите внимание, что текущий ExecutionStrategy метод не используется этим методом, так как SQL не может быть идемпотентным и не выполняется в транзакции. Можно ExecutionStrategy использовать явно, не забудьте также использовать транзакцию, если SQL не является идемпотентным.
Никогда не передайте в этот метод сцепленную или интерполированную строку ($"") с не проверенными значениями, предоставленными пользователем. Это может привести к атакам внедрения приложений SQL.
Дополнительные сведения и примеры см. в разделе "Выполнение необработанных команд SQL с помощью EF Core ".
Применяется к
ExecuteSqlRawAsync(DatabaseFacade, String, IEnumerable<Object>, CancellationToken)
- Исходный код:
- RelationalDatabaseFacadeExtensions.cs
- Исходный код:
- RelationalDatabaseFacadeExtensions.cs
- Исходный код:
- RelationalDatabaseFacadeExtensions.cs
- Исходный код:
- RelationalDatabaseFacadeExtensions.cs
- Исходный код:
- RelationalDatabaseFacadeExtensions.cs
- Исходный код:
- RelationalDatabaseFacadeExtensions.cs
- Исходный код:
- RelationalDatabaseFacadeExtensions.cs
- Исходный код:
- RelationalDatabaseFacadeExtensions.cs
- Исходный код:
- RelationalDatabaseFacadeExtensions.cs
Выполняет заданный SQL для базы данных и возвращает количество затронутых строк.
public static System.Threading.Tasks.Task<int> ExecuteSqlRawAsync(this Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade databaseFacade, string sql, System.Collections.Generic.IEnumerable<object> parameters, System.Threading.CancellationToken cancellationToken = default);
public static System.Threading.Tasks.Task<int> ExecuteSqlRawAsync(this Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade databaseFacade, string sql, System.Collections.Generic.IEnumerable<object?> parameters, System.Threading.CancellationToken cancellationToken = default);
static member ExecuteSqlRawAsync : Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade * string * seq<obj> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<int>
<Extension()>
Public Function ExecuteSqlRawAsync (databaseFacade As DatabaseFacade, sql As String, parameters As IEnumerable(Of Object), Optional cancellationToken As CancellationToken = Nothing) As Task(Of Integer)
Параметры
- databaseFacade
- DatabaseFacade
Контекст DatabaseFacade .
- sql
- String
SQL для выполнения.
- parameters
- IEnumerable<Object>
Параметры для использования с SQL.
- cancellationToken
- CancellationToken
Необходимо CancellationToken наблюдать за ожиданием завершения задачи.
Возвращаемое значение
Задача, представляющая асинхронную операцию. Результатом задачи является количество затронутых строк.
Исключения
Если отменяется CancellationToken .
Комментарии
Обратите внимание, что этот метод не запускает транзакцию. Чтобы использовать этот метод с транзакцией, сначала вызовите BeginTransaction(DatabaseFacade, IsolationLevel) или UseTransaction.
Обратите внимание, что текущий ExecutionStrategy метод не используется этим методом, так как SQL не может быть идемпотентным и не выполняется в транзакции. Метод ExecutionStrategy можно использовать явным образом, не забудьте также использовать транзакцию, если SQL не является идемпотентным.
Как и в случае с любым API, принимающего SQL, важно параметризовать любые входные данные пользователя для защиты от атаки внедрения SQL. Можно включить держатели параметров в строку запроса SQL, а затем указать значения параметров в качестве дополнительных аргументов. Все указанные значения параметров автоматически преобразуются в DbParameter.
Однако никогда не передайте в этот метод сцепленную или интерполированную строку ($"") с не проверенными значениями, предоставленными пользователем. Это может привести к атакам внедрения приложений SQL. Чтобы использовать интерполированный синтаксис строки, рекомендуется использовать для ExecuteSqlAsync(DatabaseFacade, FormattableString, CancellationToken) создания параметров.
Дополнительные сведения и примеры см. в разделе "Выполнение необработанных команд SQL с помощью EF Core ".