Язык

RelationalDatabaseFacadeExtensions.ExecuteSqlRaw Метод

Определение

Перегрузки

Имя. Описание
ExecuteSqlRaw(DatabaseFacade, String, IEnumerable<Object>)

Выполняет заданный SQL для базы данных и возвращает количество затронутых строк.

ExecuteSqlRaw(DatabaseFacade, String, Object[])

Выполняет заданный SQL для базы данных и возвращает количество затронутых строк.

ExecuteSqlRaw(DatabaseFacade, String, IEnumerable<Object>)

Исходный код:
RelationalDatabaseFacadeExtensions.cs
Исходный код:
RelationalDatabaseFacadeExtensions.cs
Исходный код:
RelationalDatabaseFacadeExtensions.cs
Исходный код:
RelationalDatabaseFacadeExtensions.cs
Исходный код:
RelationalDatabaseFacadeExtensions.cs
Исходный код:
RelationalDatabaseFacadeExtensions.cs
Исходный код:
RelationalDatabaseFacadeExtensions.cs
Исходный код:
RelationalDatabaseFacadeExtensions.cs
Исходный код:
RelationalDatabaseFacadeExtensions.cs

Выполняет заданный SQL для базы данных и возвращает количество затронутых строк.

public static int ExecuteSqlRaw(this Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade databaseFacade, string sql, System.Collections.Generic.IEnumerable<object?> parameters);
public static int ExecuteSqlRaw(this Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade databaseFacade, string sql, System.Collections.Generic.IEnumerable<object> parameters);
static member ExecuteSqlRaw : Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade * string * seq<obj> -> int
<Extension()>
Public Function ExecuteSqlRaw (databaseFacade As DatabaseFacade, sql As String, parameters As IEnumerable(Of Object)) As Integer

Параметры

databaseFacade
DatabaseFacade

Контекст DatabaseFacade .

sql
String

SQL для выполнения.

parameters
IEnumerable<Object>

Параметры для использования с SQL.

Возвращаемое значение

Количество затронутых строк.

Комментарии

Обратите внимание, что этот метод не запускает транзакцию. Чтобы использовать этот метод с транзакцией, сначала вызовите BeginTransaction(DatabaseFacade, IsolationLevel) или UseTransaction.

Обратите внимание, что текущий ExecutionStrategy метод не используется этим методом, так как SQL не может быть идемпотентным и не выполняется в транзакции. Можно ExecutionStrategy использовать явно, не забудьте также использовать транзакцию, если SQL не является идемпотентным.

Как и в случае с любым API, принимающего SQL, важно параметризовать любые входные данные пользователя для защиты от атаки внедрения SQL. Можно включить держатели параметров в строку запроса SQL, а затем указать значения параметров в качестве дополнительных аргументов. Все указанные значения параметров автоматически преобразуются в DbParameter.

Однако никогда не передайте в этот метод сцепленную или интерполированную строку ($"") с не проверенными значениями, предоставленными пользователем. Это может привести к атакам внедрения приложений SQL. Чтобы использовать интерполированный синтаксис строки, рекомендуется использовать для ExecuteSql(DatabaseFacade, FormattableString) создания параметров.

Дополнительные сведения и примеры см. в разделе "Выполнение необработанных команд SQL с помощью EF Core ".

Применяется к

ExecuteSqlRaw(DatabaseFacade, String, Object[])

Исходный код:
RelationalDatabaseFacadeExtensions.cs
Исходный код:
RelationalDatabaseFacadeExtensions.cs
Исходный код:
RelationalDatabaseFacadeExtensions.cs
Исходный код:
RelationalDatabaseFacadeExtensions.cs
Исходный код:
RelationalDatabaseFacadeExtensions.cs
Исходный код:
RelationalDatabaseFacadeExtensions.cs
Исходный код:
RelationalDatabaseFacadeExtensions.cs
Исходный код:
RelationalDatabaseFacadeExtensions.cs
Исходный код:
RelationalDatabaseFacadeExtensions.cs

Выполняет заданный SQL для базы данных и возвращает количество затронутых строк.

public static int ExecuteSqlRaw(this Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade databaseFacade, string sql, params object?[] parameters);
public static int ExecuteSqlRaw(this Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade databaseFacade, string sql, params object[] parameters);
static member ExecuteSqlRaw : Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade * string * obj[] -> int
<Extension()>
Public Function ExecuteSqlRaw (databaseFacade As DatabaseFacade, sql As String, ParamArray parameters As Object()) As Integer

Параметры

databaseFacade
DatabaseFacade

Контекст DatabaseFacade .

sql
String

SQL для выполнения.

parameters
Object[]

Параметры для использования с SQL.

Возвращаемое значение

Количество затронутых строк.

Комментарии

Обратите внимание, что этот метод не запускает транзакцию. Чтобы использовать этот метод с транзакцией, сначала вызовите BeginTransaction(DatabaseFacade, IsolationLevel) или UseTransaction.

Обратите внимание, что текущий ExecutionStrategy метод не используется этим методом, так как SQL не может быть идемпотентным и не выполняется в транзакции. Можно ExecutionStrategy использовать явно, не забудьте также использовать транзакцию, если SQL не является идемпотентным.

Как и в случае с любым API, принимающего SQL, важно параметризовать любые входные данные пользователя для защиты от атаки внедрения SQL. Можно включить держатели параметров в строку запроса SQL, а затем указать значения параметров в качестве дополнительных аргументов. Все указанные значения параметров автоматически преобразуются в DbParameter.

Однако никогда не передайте в этот метод сцепленную или интерполированную строку ($"") с не проверенными значениями, предоставленными пользователем. Это может привести к атакам внедрения приложений SQL. Чтобы использовать интерполированный синтаксис строки, рекомендуется использовать для ExecuteSql(DatabaseFacade, FormattableString) создания параметров.

Дополнительные сведения и примеры см. в разделе "Выполнение необработанных команд SQL с помощью EF Core ".

Применяется к