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<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 ".