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)
Создает запрос 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 (обычно ).DbSet<TEntity>
Интерполированная строка, представляющая SQL-запрос с параметрами.
Возвращаемое значение
Объект , IQueryable<T> представляющий запрос SQL с интерполированной строкой.
Комментарии
Если поставщик базы данных поддерживает создание в предоставленном SQL, можно создать поверх необработанного SQL-запроса с помощью операторов LINQ.
Как и в случае с любым API, который принимает SQL, важно параметризовать любые входные данные пользователя для защиты от атак путем внедрения кода SQL. В строку ЗАПРОСА SQL можно включить интерполированные заполнители параметров. Все значения интерполированных параметров будут автоматически преобразованы в DbParameter.
Дополнительные сведения и примеры см. в статье Выполнение необработанных команд SQL с помощью EF Core .
Применяется к
FromSql<TEntity>(IQueryable<TEntity>, FormattableString)
Внимание!
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 (обычно ).DbSet<TEntity>
Интерполированная строка, представляющая SQL-запрос.
Возвращаемое значение
Объект , IQueryable<T> представляющий запрос SQL с интерполированной строкой.
- Атрибуты
Применяется к
FromSql<TEntity>(IQueryable<TEntity>, RawSqlString, Object[])
Внимание!
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-запрос.
Применяется к
Entity Framework
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по