RelationalQueryableExtensions.FromSql 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
重载
| FromSql<TEntity>(DbSet<TEntity>, FormattableString) |
基于表示 SQL 查询的内插字符串创建 LINQ 查询。 |
| FromSql<TEntity>(IQueryable<TEntity>, FormattableString) |
已过时.
基于表示 SQL 查询的内插字符串创建 LINQ 查询。
如果数据库提供程序支持在提供的 SQL 上进行撰写，则可以使用 LINQ 运算符在原始 SQL 查询的基础上进行撰写 -
与任何接受 SQL 的 API 一样，必须参数化任何用户输入，以防止 SQL 注入攻击。 可以在 SQL 查询字符串中包含内插参数占位符。 提供的任何内插参数值将自动转换为 DbParameter - |
| FromSql<TEntity>(IQueryable<TEntity>, RawSqlString, Object[]) |
已过时.
基于原始 SQL 查询创建 LINQ 查询。
如果数据库提供程序支持在提供的 SQL 上进行撰写，则可以使用 LINQ 运算符在原始 SQL 查询的基础上进行撰写 -
与任何接受 SQL 的 API 一样，必须参数化任何用户输入，以防止 SQL 注入攻击。 可以在 SQL 查询字符串中包含参数占位符，然后将参数值作为其他参数提供。 提供的任何参数值将自动转换为 DbParameter -
此重载还接受 DbParameter 实例作为参数值。 这允许在 SQL 查询字符串中使用命名参数 - |
| FromSql<TEntity>(IQueryable<TEntity>, String, Object[]) |
基于原始 SQL 查询创建 LINQ 查询。
如果数据库提供程序支持在提供的 SQL 上进行撰写，则可以使用 LINQ 运算符在原始 SQL 查询的基础上进行撰写 -
与任何接受 SQL 的 API 一样，必须参数化任何用户输入，以防止 SQL 注入攻击。 可以在 SQL 查询字符串中包含参数占位符，然后将参数值作为其他参数提供。 提供的任何参数值将自动转换为 DbParameter -
还可以构造 DbParameter 并将其作为参数值提供给 。 这允许在 SQL 查询字符串中使用命名参数 - |
FromSql<TEntity>(DbSet<TEntity>, FormattableString)
基于表示 SQL 查询的内插字符串创建 LINQ 查询。
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 上进行撰写，则可以使用 LINQ 运算符在原始 SQL 查询的基础上进行撰写。
与任何接受 SQL 的 API 一样，必须参数化任何用户输入，以防止 SQL 注入攻击。 可以在 SQL 查询字符串中包含内插参数占位符。 提供的任何内插参数值将自动转换为 DbParameter。
有关详细信息和示例 ，请参阅使用 EF Core 执行原始 SQL 命令 。
适用于
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.
基于表示 SQL 查询的内插字符串创建 LINQ 查询。
如果数据库提供程序支持在提供的 SQL 上进行撰写，则可以使用 LINQ 运算符在原始 SQL 查询的基础上进行撰写 - context.Blogs.FromSql("SELECT * FROM dbo.Blogs").OrderBy(b => b.Name)。
与任何接受 SQL 的 API 一样，必须参数化任何用户输入，以防止 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.
基于原始 SQL 查询创建 LINQ 查询。
如果数据库提供程序支持在提供的 SQL 上进行撰写，则可以使用 LINQ 运算符在原始 SQL 查询的基础上进行撰写 - context.Blogs.FromSql("SELECT * FROM dbo.Blogs").OrderBy(b => b.Name)。
与任何接受 SQL 的 API 一样，必须参数化任何用户输入，以防止 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 查询。 铌。 可以在此处传递字符串文本，因为 RawSqlString 可以隐式转换为字符串。
- parameters
- Object[]
要分配给参数的值。
返回
表示 IQueryable<T> 原始 SQL 查询的 。
- 属性
适用于
FromSql<TEntity>(IQueryable<TEntity>, String, Object[])
基于原始 SQL 查询创建 LINQ 查询。
如果数据库提供程序支持在提供的 SQL 上进行撰写，则可以使用 LINQ 运算符在原始 SQL 查询的基础上进行撰写 - context.Blogs.FromSql("SELECT * FROM dbo.Blogs").OrderBy(b => b.Name)。
与任何接受 SQL 的 API 一样，必须参数化任何用户输入，以防止 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 查询的 。
