Язык

RelationalDatabaseFacadeExtensions.SqlQueryRaw<TResult> Метод

Определение

Создает запрос LINQ на основе необработанного SQL-запроса, который возвращает результирующий набор скалярного типа, который изначально поддерживается поставщиком базы данных.

public static System.Linq.IQueryable<TResult> SqlQueryRaw<TResult>(this Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade databaseFacade, string sql, params object[] parameters);
public static System.Linq.IQueryable<TResult> SqlQueryRaw<TResult>(this Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade databaseFacade, string sql, params object?[] parameters);
static member SqlQueryRaw : Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade * string * obj[] -> System.Linq.IQueryable<'Result>
<Extension()>
Public Function SqlQueryRaw(Of TResult) (databaseFacade As DatabaseFacade, sql As String, ParamArray parameters As Object()) As IQueryable(Of TResult)

Параметры типа

TResult

Параметры

databaseFacade
DatabaseFacade

Контекст DatabaseFacade .

sql
String

Необработанный SQL-запрос.

parameters
Object[]

Значения, назначенные параметрам.

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

IQueryable<TResult>

Представляет IQueryable<T> необработанный SQL-запрос.

Комментарии

Чтобы использовать этот метод с типом возвращаемого значения, который не поддерживается поставщиком базы данных, используйте DefaultTypeMapping<TScalar>(Action<TypeMappingConfigurationBuilder<TScalar>>) этот метод.

Возвращаемый IQueryable<T> объект можно создать с помощью LINQ для создания более сложных запросов.

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

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

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

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

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