Database.SqlQuery<TElement> 方法 (String, Object[])
[本页针对的是实体框架版本 6。最新版本以“实体框架”NuGet 包的形式提供。有关实体框架的更多信息，请参见 msdn.com/data/ef。]
创建一个原始 SQL 查询，该查询将返回给定泛型类型的元素。 类型可以是包含与从查询返回的列名匹配的属性的任何类型，也可以是简单的基元类型。 该类型不必是实体类型。 即使返回对象的类型是实体类型，上下文也决不会跟踪此查询的结果。 使用 SqlQuery(String, Object[]) 方法可返回上下文跟踪的实体。 与接受 SQL 的任何 API 一样，对任何用户输入进行参数化以便避免 SQL 注入攻击是十分重要的。 您可以在 SQL 查询字符串中包含参数占位符，然后将参数值作为附加参数提供。 您提供的任何参数值都将自动转换为 DbParameter。 context.Database.SqlQuery<Post>("SELECT * FROM dbo.Posts WHERE Author = @p0", userSuppliedAuthor); 或者，您还可以构造一个 DbParameter 并将它提供给 SqlQuery。 这允许您在 SQL 查询字符串中使用命名参数。 context.Database.SqlQuery<Post>("SELECT * FROM dbo.Posts WHERE Author = @author", new SqlParameter("@author", userSuppliedAuthor));
命名空间： System.Data.Entity
程序集： EntityFramework（在 EntityFramework.dll 中）
语法
声明
Public Function SqlQuery(Of TElement) ( _
sql As String, _
ParamArray parameters As Object() _
) As DbRawSqlQuery(Of TElement)
用法
Dim instance As Database
Dim sql As String
Dim parameters As Object()
Dim returnValue As DbRawSqlQuery(Of TElement)
returnValue = instance.SqlQuery(sql, parameters)
public DbRawSqlQuery<TElement> SqlQuery<TElement>(
string sql,
params Object[] parameters
)
public:
generic<typename TElement>
DbRawSqlQuery<TElement>^ SqlQuery(
String^ sql,
... array<Object^>^ parameters
)
member SqlQuery :
sql:string *
parameters:Object[] -> DbRawSqlQuery<'TElement>
JScript does not support generic types and methods.
类型参数
- TElement
查询所返回对象的类型。
参数
- sql
类型：System.String
SQL 查询字符串。
- parameters
类型：System.Object[]
要应用于 SQL 查询字符串的参数。 如果使用输出参数，则它们的值在完全读取结果之前不可用。 这是由于 DbDataReader 的基础行为而导致的，有关详细信息，请参见 https://go.microsoft.com/fwlink/?LinkID=398589。
返回值
类型：System.Data.Entity.Infrastructure.DbRawSqlQuery<TElement>
一个 DbRawSqlQuery<TElement> 对象，此对象在枚举时将执行查询。