RelationalQueryableExtensions.FromSql Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перегрузки
| Имя. | Описание |
|---|---|
| FromSql<TEntity>(DbSet<TEntity>, FormattableString) |
Создает запрос LINQ на основе интерполированной строки, представляющей SQL-запрос. |
| FromSql<TEntity>(IQueryable<TEntity>, FormattableString) |
Устаревшие.
Создает запрос LINQ на основе интерполированной строки, представляющей SQL-запрос.
Если поставщик базы данных поддерживает создание в предоставленном SQL, можно создать на основе необработанного SQL-запроса с помощью операторов LINQ .
Как и в случае с любым API, принимающего SQL, важно параметризовать любые входные данные пользователя для защиты от атаки внедрения SQL. Можно включить в строку запроса SQL интерполированный параметр. Все значения интерполированных параметров, которые вы предоставляете, автоматически преобразуются в DbParameter - |
| FromSql<TEntity>(IQueryable<TEntity>, RawSqlString, Object[]) |
Устаревшие.
Создает запрос LINQ на основе необработанного SQL-запроса.
Если поставщик базы данных поддерживает создание в предоставленном SQL, можно создать на основе необработанного SQL-запроса с помощью операторов LINQ .
Как и в случае с любым API, принимающего SQL, важно параметризовать любые входные данные пользователя для защиты от атаки внедрения SQL. Можно включить держатели параметров в строку запроса SQL, а затем указать значения параметров в качестве дополнительных аргументов. Все указанные значения параметров автоматически преобразуются в DbParameter .
Эта перегрузка также принимает экземпляры DbParameter в качестве значений параметров. Это позволяет использовать именованные параметры в строке запроса SQL. |
| FromSql<TEntity>(IQueryable<TEntity>, String, Object[]) |
Создает запрос LINQ на основе необработанного SQL-запроса.
Если поставщик базы данных поддерживает создание в предоставленном SQL, можно создать на основе необработанного SQL-запроса с помощью операторов LINQ .
Как и в случае с любым API, принимающего SQL, важно параметризовать любые входные данные пользователя для защиты от атаки внедрения SQL. Можно включить держатели параметров в строку запроса SQL, а затем указать значения параметров в качестве дополнительных аргументов. Все указанные значения параметров автоматически преобразуются в DbParameter .
Можно также создать DbParameter и предоставить его в качестве значения параметра. Это позволяет использовать именованные параметры в строке запроса SQL. |
FromSql<TEntity>(DbSet<TEntity>, FormattableString)
- Исходный код:
- RelationalQueryableExtensions.cs
- Исходный код:
- RelationalQueryableExtensions.cs
- Исходный код:
- RelationalQueryableExtensions.cs
- Исходный код:
- RelationalQueryableExtensions.cs
- Исходный код:
- RelationalQueryableExtensions.cs
Создает запрос LINQ на основе интерполированной строки, представляющей SQL-запрос.
public static System.Linq.IQueryable<TEntity> FromSql<TEntity>(this Microsoft.EntityFrameworkCore.DbSet<TEntity> source, FormattableString sql) where TEntity : class;
static member FromSql : Microsoft.EntityFrameworkCore.DbSet<'Entity (requires 'Entity : null)> * FormattableString -> System.Linq.IQueryable<'Entity (requires 'Entity : null)> (requires 'Entity : null)
<Extension()>
Public Function FromSql(Of TEntity As Class) (source As DbSet(Of TEntity), sql As FormattableString) As IQueryable(Of TEntity)
Параметры типа
- TEntity
Тип элементов source.
Параметры
- source
- DbSet<TEntity>
Значение IQueryable<T> , используемое в качестве основы интерполированного запроса SQL строки (как правило, a DbSet<TEntity>).
Интерполированная строка, представляющая SQL-запрос с параметрами.
Возвращаемое значение
Объект IQueryable<T> , представляющий интерполированный строковый SQL-запрос.
Комментарии
Если поставщик базы данных поддерживает создание в предоставленном SQL, можно создать на основе необработанного SQL-запроса с помощью операторов LINQ.
Как и в случае с любым API, принимающего SQL, важно параметризовать любые входные данные пользователя для защиты от атаки внедрения SQL. Можно включить в строку запроса SQL интерполированный параметр. Все значения интерполированных параметров, которые вы предоставляете, автоматически преобразуются в .DbParameter
Дополнительные сведения и примеры см. в разделе "Выполнение необработанных команд SQL с помощью EF Core ".
Применяется к
FromSql<TEntity>(IQueryable<TEntity>, FormattableString)
- Исходный код:
- RelationalQueryableExtensions.cs
- Исходный код:
- RelationalQueryableExtensions.cs
- Исходный код:
- RelationalQueryableExtensions.cs
- Исходный код:
- RelationalQueryableExtensions.cs
Внимание!
For returning objects from SQL queries using plain strings, use FromSqlRaw instead. For returning objects from SQL queries using interpolated string syntax to create parameters, use FromSqlInterpolated instead. Call either new method directly on the DbSet at the root of the query.
Создает запрос LINQ на основе интерполированной строки, представляющей SQL-запрос.
Если поставщик базы данных поддерживает создание в предоставленном SQL, можно создать на основе необработанного SQL-запроса с помощью операторов LINQ . context.Blogs.FromSql("SELECT * FROM dbo.Blogs").OrderBy(b => b.Name)
Как и в случае с любым API, принимающего SQL, важно параметризовать любые входные данные пользователя для защиты от атаки внедрения SQL. Можно включить в строку запроса SQL интерполированный параметр. Все значения интерполированных параметров, которые вы предоставляете, автоматически преобразуются в DbParameter - context.Blogs.FromSql($"SELECT * FROM [dbo].[SearchBlogs]({userSuppliedSearchTerm})").
public static System.Linq.IQueryable<TEntity> FromSql<TEntity>(this System.Linq.IQueryable<TEntity> source, FormattableString sql) where TEntity : class;
[System.Obsolete("For returning objects from SQL queries using plain strings, use FromSqlRaw instead. For returning objects from SQL queries using interpolated string syntax to create parameters, use FromSqlInterpolated instead. Call either new method directly on the DbSet at the root of the query.", true)]
public static System.Linq.IQueryable<TEntity> FromSql<TEntity>(this System.Linq.IQueryable<TEntity> source, FormattableString sql) where TEntity : class;
static member FromSql : System.Linq.IQueryable<'Entity (requires 'Entity : null)> * FormattableString -> System.Linq.IQueryable<'Entity (requires 'Entity : null)> (requires 'Entity : null)
[<System.Obsolete("For returning objects from SQL queries using plain strings, use FromSqlRaw instead. For returning objects from SQL queries using interpolated string syntax to create parameters, use FromSqlInterpolated instead. Call either new method directly on the DbSet at the root of the query.", true)>]
static member FromSql : System.Linq.IQueryable<'Entity (requires 'Entity : null)> * FormattableString -> System.Linq.IQueryable<'Entity (requires 'Entity : null)> (requires 'Entity : null)
<Extension()>
Public Function FromSql(Of TEntity As Class) (source As IQueryable(Of TEntity), sql As FormattableString) As IQueryable(Of TEntity)
Параметры типа
- TEntity
Тип элементов source.
Параметры
- source
- IQueryable<TEntity>
Значение IQueryable<T> , используемое в качестве основы интерполированного запроса SQL строки (как правило, a DbSet<TEntity>).
Интерполированная строка, представляющая SQL-запрос.
Возвращаемое значение
Объект IQueryable<T> , представляющий интерполированный строковый SQL-запрос.
- Атрибуты
Применяется к
FromSql<TEntity>(IQueryable<TEntity>, RawSqlString, Object[])
- Исходный код:
- RelationalQueryableExtensions.cs
- Исходный код:
- RelationalQueryableExtensions.cs
- Исходный код:
- RelationalQueryableExtensions.cs
- Исходный код:
- RelationalQueryableExtensions.cs
Внимание!
For returning objects from SQL queries using plain strings, use FromSqlRaw instead. For returning objects from SQL queries using interpolated string syntax to create parameters, use FromSqlInterpolated instead. Call either new method directly on the DbSet at the root of the query.
Создает запрос LINQ на основе необработанного SQL-запроса.
Если поставщик базы данных поддерживает создание в предоставленном SQL, можно создать на основе необработанного SQL-запроса с помощью операторов LINQ . context.Blogs.FromSql("SELECT * FROM dbo.Blogs").OrderBy(b => b.Name)
Как и в случае с любым API, принимающего SQL, важно параметризовать любые входные данные пользователя для защиты от атаки внедрения SQL. Можно включить держатели параметров в строку запроса SQL, а затем указать значения параметров в качестве дополнительных аргументов. Все указанные значения параметров автоматически преобразуются в DbParameter . context.Blogs.FromSql("SELECT * FROM [dbo].[SearchBlogs]({0})", userSuppliedSearchTerm)
Эта перегрузка также принимает экземпляры DbParameter в качестве значений параметров. Это позволяет использовать именованные параметры в строке запроса SQL. context.Blogs.FromSql("SELECT * FROM [dbo].[SearchBlogs]({@searchTerm})", new SqlParameter("@searchTerm", userSuppliedSearchTerm))
public static System.Linq.IQueryable<TEntity> FromSql<TEntity>(this System.Linq.IQueryable<TEntity> source, Microsoft.EntityFrameworkCore.RawSqlString sql, params object[] parameters) where TEntity : class;
[System.Obsolete("For returning objects from SQL queries using plain strings, use FromSqlRaw instead. For returning objects from SQL queries using interpolated string syntax to create parameters, use FromSqlInterpolated instead. Call either new method directly on the DbSet at the root of the query.", true)]
public static System.Linq.IQueryable<TEntity> FromSql<TEntity>(this System.Linq.IQueryable<TEntity> source, Microsoft.EntityFrameworkCore.RawSqlString sql, params object[] parameters) where TEntity : class;
static member FromSql : System.Linq.IQueryable<'Entity (requires 'Entity : null)> * Microsoft.EntityFrameworkCore.RawSqlString * obj[] -> System.Linq.IQueryable<'Entity (requires 'Entity : null)> (requires 'Entity : null)
[<System.Obsolete("For returning objects from SQL queries using plain strings, use FromSqlRaw instead. For returning objects from SQL queries using interpolated string syntax to create parameters, use FromSqlInterpolated instead. Call either new method directly on the DbSet at the root of the query.", true)>]
static member FromSql : System.Linq.IQueryable<'Entity (requires 'Entity : null)> * Microsoft.EntityFrameworkCore.RawSqlString * obj[] -> System.Linq.IQueryable<'Entity (requires 'Entity : null)> (requires 'Entity : null)
<Extension()>
Public Function FromSql(Of TEntity As Class) (source As IQueryable(Of TEntity), sql As RawSqlString, ParamArray parameters As Object()) As IQueryable(Of TEntity)
Параметры типа
- TEntity
Тип элементов source.
Параметры
- source
- IQueryable<TEntity>
Использование IQueryable<T> в качестве базы необработанного SQL-запроса (как правило DbSet<TEntity>, ).
- sql
- RawSqlString
Необработанный SQL-запрос. NB. Строковый литерал можно передать здесь, так как RawSqlString неявно преобразуется в строку.
- parameters
- Object[]
Значения, назначенные параметрам.
Возвращаемое значение
Представляет IQueryable<T> необработанный SQL-запрос.
- Атрибуты
Применяется к
FromSql<TEntity>(IQueryable<TEntity>, String, Object[])
Создает запрос LINQ на основе необработанного SQL-запроса.
Если поставщик базы данных поддерживает создание в предоставленном SQL, можно создать на основе необработанного SQL-запроса с помощью операторов LINQ . context.Blogs.FromSql("SELECT * FROM dbo.Blogs").OrderBy(b => b.Name)
Как и в случае с любым API, принимающего SQL, важно параметризовать любые входные данные пользователя для защиты от атаки внедрения SQL. Можно включить держатели параметров в строку запроса SQL, а затем указать значения параметров в качестве дополнительных аргументов. Все указанные значения параметров автоматически преобразуются в DbParameter . context.Blogs.FromSql("SELECT * FROM [dbo].[SearchBlogs]({0})", userSuppliedSearchTerm)
Можно также создать DbParameter и предоставить его в качестве значения параметра. Это позволяет использовать именованные параметры в строке запроса SQL. context.Blogs.FromSql("SELECT * FROM [dbo].[SearchBlogs]({@searchTerm})", new SqlParameter("@searchTerm", userSuppliedSearchTerm))
public static System.Linq.IQueryable<TEntity> FromSql<TEntity>(this System.Linq.IQueryable<TEntity> source, string sql, params object[] parameters) where TEntity : class;
static member FromSql : System.Linq.IQueryable<'Entity (requires 'Entity : null)> * string * obj[] -> System.Linq.IQueryable<'Entity (requires 'Entity : null)> (requires 'Entity : null)
<Extension()>
Public Function FromSql(Of TEntity As Class) (source As IQueryable(Of TEntity), sql As String, ParamArray parameters As Object()) As IQueryable(Of TEntity)
Параметры типа
- TEntity
Тип элементов source.
Параметры
- source
- IQueryable<TEntity>
Использование IQueryable<T> в качестве базы необработанного SQL-запроса (как правило DbSet<TEntity>, ).
- sql
- String
Необработанный SQL-запрос.
- parameters
- Object[]
Значения, назначенные параметрам.
Возвращаемое значение
Представляет IQueryable<T> необработанный SQL-запрос.