通过

ObjectContext.ExecuteStoreQueryAsync 方法

  • 参考

定义

命名空间:
System.Data.Entity.Core.Objects
程序集:
EntityFramework.dll

重载

ExecuteStoreQueryAsync<TElement>(String, Object[])

直接对数据源异步执行查询，并返回类型化结果序列。 查询是使用服务器的本机查询语言（如 SQL）指定的。 上下文不跟踪结果，请使用指定实体集名称的重载来跟踪结果。

与任何接受 SQL 的 API 一样，必须参数化任何用户输入，以防止 SQL 注入攻击。 可以在 SQL 查询字符串中包含参数占位符，然后将参数值作为其他参数提供。 提供的任何参数值将自动转换为 DbParameter。 上下文。ExecuteStoreQueryAsync<Post> (“SELECT * FROM dbo。文章 WHERE Author = @p0“， userSuppliedAuthor) ;或者，还可以构造 DbParameter 并将其提供给 SqlQuery。 这样可以在 SQL 查询字符串中使用命名参数。 上下文。ExecuteStoreQueryAsync<Post> (“SELECT * FROM dbo。文章 WHERE Author = @author“， new SqlParameter (”@author“， userSuppliedAuthor) ) ;
ExecuteStoreQueryAsync<TElement>(String, ExecutionOptions, Object[])

直接对数据源异步执行查询，并返回类型化结果序列。 查询是使用服务器的本机查询语言（如 SQL）指定的。 上下文不跟踪结果，请使用指定实体集名称的重载来跟踪结果。

与任何接受 SQL 的 API 一样，必须参数化任何用户输入，以防止 SQL 注入攻击。 可以在 SQL 查询字符串中包含参数占位符，然后将参数值作为其他参数提供。 提供的任何参数值将自动转换为 DbParameter。 上下文。ExecuteStoreQueryAsync<Post> (“SELECT * FROM dbo。文章 WHERE Author = @p0“， userSuppliedAuthor) ;或者，还可以构造 DbParameter 并将其提供给 SqlQuery。 这样可以在 SQL 查询字符串中使用命名参数。 上下文。ExecuteStoreQueryAsync<Post> (“SELECT * FROM dbo。文章 WHERE Author = @author“， new SqlParameter (”@author“， userSuppliedAuthor) ) ;
ExecuteStoreQueryAsync<TElement>(String, CancellationToken, Object[])

直接对数据源异步执行查询，并返回类型化结果序列。 查询是使用服务器的本机查询语言（如 SQL）指定的。 上下文不跟踪结果，请使用指定实体集名称的重载来跟踪结果。

与任何接受 SQL 的 API 一样，必须参数化任何用户输入，以防止 SQL 注入攻击。 可以在 SQL 查询字符串中包含参数位置持有者，然后将参数值作为其他参数提供。 提供的任何参数值将自动转换为 DbParameter。 上下文。ExecuteStoreQueryAsync<Post> (“SELECT * FROM dbo。文章 WHERE Author = @p0“， userSuppliedAuthor) ;或者，还可以构造 DbParameter 并将其提供给 SqlQuery。 这样可以在 SQL 查询字符串中使用命名参数。 上下文。ExecuteStoreQueryAsync<Post> (“SELECT * FROM dbo。文章 WHERE Author = @author“， new SqlParameter (”@author“， userSuppliedAuthor) ) ;
ExecuteStoreQueryAsync<TElement>(String, ExecutionOptions, CancellationToken, Object[])

直接对数据源异步执行查询，并返回类型化结果序列。 查询是使用服务器的本机查询语言（如 SQL）指定的。 上下文不跟踪结果，请使用指定实体集名称的重载来跟踪结果。

与任何接受 SQL 的 API 一样，必须参数化任何用户输入，以防止 SQL 注入攻击。 可以在 SQL 查询字符串中包含参数占位符，然后将参数值作为其他参数提供。 提供的任何参数值将自动转换为 DbParameter。 上下文。ExecuteStoreQueryAsync<Post> (“SELECT * FROM dbo。文章 WHERE Author = @p0“， userSuppliedAuthor) ;或者，还可以构造 DbParameter 并将其提供给 SqlQuery。 这样可以在 SQL 查询字符串中使用命名参数。 上下文。ExecuteStoreQueryAsync<Post> (“SELECT * FROM dbo。文章 WHERE Author = @author“， new SqlParameter (”@author“， userSuppliedAuthor) ) ;
ExecuteStoreQueryAsync<TElement>(String, String, ExecutionOptions, Object[])

直接对数据源异步执行查询，并返回类型化结果序列。 查询是使用服务器的本机查询语言（如 SQL）指定的。 如果指定了实体集名称，则上下文将跟踪结果。

与任何接受 SQL 的 API 一样，必须参数化任何用户输入，以防止 SQL 注入攻击。 可以在 SQL 查询字符串中包含参数占位符，然后将参数值作为其他参数提供。 提供的任何参数值将自动转换为 DbParameter。 上下文。ExecuteStoreQueryAsync<Post> (“SELECT * FROM dbo。文章 WHERE Author = @p0“， userSuppliedAuthor) ;或者，还可以构造 DbParameter 并将其提供给 SqlQuery。 这样可以在 SQL 查询字符串中使用命名参数。 上下文。ExecuteStoreQueryAsync<Post> (“SELECT * FROM dbo。文章 WHERE Author = @author“， new SqlParameter (”@author“， userSuppliedAuthor) ) ;
ExecuteStoreQueryAsync<TElement>(String, String, ExecutionOptions, CancellationToken, Object[])

直接对数据源异步执行查询，并返回类型化结果序列。 查询是使用服务器的本机查询语言（如 SQL）指定的。 如果指定了实体集名称，则上下文将跟踪结果。

与任何接受 SQL 的 API 一样，必须参数化任何用户输入，以防止 SQL 注入攻击。 可以在 SQL 查询字符串中包含参数占位符，然后将参数值作为其他参数提供。 提供的任何参数值将自动转换为 DbParameter。 上下文。ExecuteStoreQueryAsync<Post> (“SELECT * FROM dbo。文章 WHERE Author = @p0“， userSuppliedAuthor) ;或者，还可以构造 DbParameter 并将其提供给 SqlQuery。 这样可以在 SQL 查询字符串中使用命名参数。 上下文。ExecuteStoreQueryAsync<Post> (“SELECT * FROM dbo。文章 WHERE Author = @author“， new SqlParameter (”@author“， userSuppliedAuthor) ) ;

ExecuteStoreQueryAsync<TElement>(String, Object[])

直接对数据源异步执行查询，并返回类型化结果序列。 查询是使用服务器的本机查询语言（如 SQL）指定的。 上下文不跟踪结果，请使用指定实体集名称的重载来跟踪结果。

与任何接受 SQL 的 API 一样，必须参数化任何用户输入，以防止 SQL 注入攻击。 可以在 SQL 查询字符串中包含参数位置持有者，然后将参数值作为其他参数提供。 提供的任何参数值将自动转换为 DbParameter。 上下文。ExecuteStoreQueryAsync<Post> (“SELECT * FROM dbo。文章 WHERE Author = @p0“， userSuppliedAuthor) ;或者，还可以构造 DbParameter 并将其提供给 SqlQuery。 这样可以在 SQL 查询字符串中使用命名参数。 上下文。ExecuteStoreQueryAsync<Post> (“SELECT * FROM dbo。文章 WHERE Author = @author“， new SqlParameter (”@author“， userSuppliedAuthor) ) ;

[System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Design", "CA1006:DoNotNestGenericTypesInMemberSignatures")]
public System.Threading.Tasks.Task<System.Data.Entity.Core.Objects.ObjectResult<TElement>> ExecuteStoreQueryAsync<TElement> (string commandText, params object[] parameters);
member this.ExecuteStoreQueryAsync : string * obj[] -> System.Threading.Tasks.Task<System.Data.Entity.Core.Objects.ObjectResult<'Element>>
Public Function ExecuteStoreQueryAsync(Of TElement) (commandText As String, ParamArray parameters As Object()) As Task(Of ObjectResult(Of TElement))

类型参数

TElement

结果序列的元素类型。

参数

commandText
String

用服务器的本机查询语言指定的查询。

parameters
Object[]

要用于查询的参数值。 如果使用输出参数，则在完全读取结果之前，这些参数的值将不可用。 这是由于 DbDataReader 的基本行为造成的，有关详细信息，请参阅 http://go.microsoft.com/fwlink/?LinkID=398589 。

返回

Task<ObjectResult<TElement>>

表示异步操作的任务。 任务结果包含 类型的 TElement 对象的枚举。

属性
SuppressMessageAttribute

注解

不支持对同一上下文实例执行多个活动操作。 使用“await”确保在此上下文上调用另一个方法之前已完成所有异步操作。

适用于

ExecuteStoreQueryAsync<TElement>(String, ExecutionOptions, Object[])

直接对数据源异步执行查询，并返回类型化结果序列。 查询是使用服务器的本机查询语言（如 SQL）指定的。 上下文不跟踪结果，请使用指定实体集名称的重载来跟踪结果。

与任何接受 SQL 的 API 一样，必须参数化任何用户输入，以防止 SQL 注入攻击。 可以在 SQL 查询字符串中包含参数位置持有者，然后将参数值作为其他参数提供。 提供的任何参数值将自动转换为 DbParameter。 上下文。ExecuteStoreQueryAsync<Post> (“SELECT * FROM dbo。文章 WHERE Author = @p0“， userSuppliedAuthor) ;或者，还可以构造 DbParameter 并将其提供给 SqlQuery。 这样可以在 SQL 查询字符串中使用命名参数。 上下文。ExecuteStoreQueryAsync<Post> (“SELECT * FROM dbo。文章 WHERE Author = @author“， new SqlParameter (”@author“， userSuppliedAuthor) ) ;

[System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Design", "CA1006:DoNotNestGenericTypesInMemberSignatures")]
public virtual System.Threading.Tasks.Task<System.Data.Entity.Core.Objects.ObjectResult<TElement>> ExecuteStoreQueryAsync<TElement> (string commandText, System.Data.Entity.Core.Objects.ExecutionOptions executionOptions, params object[] parameters);
abstract member ExecuteStoreQueryAsync : string * System.Data.Entity.Core.Objects.ExecutionOptions * obj[] -> System.Threading.Tasks.Task<System.Data.Entity.Core.Objects.ObjectResult<'Element>>
override this.ExecuteStoreQueryAsync : string * System.Data.Entity.Core.Objects.ExecutionOptions * obj[] -> System.Threading.Tasks.Task<System.Data.Entity.Core.Objects.ObjectResult<'Element>>

类型参数

TElement

结果序列的元素类型。

参数

commandText
String

用服务器的本机查询语言指定的查询。

executionOptions
ExecutionOptions

用于执行此查询的选项。

parameters
Object[]

要用于查询的参数值。 如果使用输出参数，则在完全读取结果之前，这些参数的值将不可用。 这是由于 DbDataReader 的基本行为造成的，有关详细信息，请参阅 http://go.microsoft.com/fwlink/?LinkID=398589 。

返回

Task<ObjectResult<TElement>>

表示异步操作的任务。 任务结果包含 类型的 TElement 对象的枚举。

属性
SuppressMessageAttribute

注解

不支持对同一上下文实例执行多个活动操作。 使用“await”确保在此上下文上调用另一个方法之前已完成所有异步操作。

适用于

ExecuteStoreQueryAsync<TElement>(String, CancellationToken, Object[])

直接对数据源异步执行查询，并返回类型化结果序列。 查询是使用服务器的本机查询语言（如 SQL）指定的。 上下文不跟踪结果，请使用指定实体集名称的重载来跟踪结果。

与任何接受 SQL 的 API 一样，必须参数化任何用户输入，以防止 SQL 注入攻击。 可以在 SQL 查询字符串中包含参数位置持有者，然后将参数值作为其他参数提供。 提供的任何参数值将自动转换为 DbParameter。 上下文。ExecuteStoreQueryAsync<Post> (“SELECT * FROM dbo。文章 WHERE Author = @p0“， userSuppliedAuthor) ;或者，还可以构造 DbParameter 并将其提供给 SqlQuery。 这样可以在 SQL 查询字符串中使用命名参数。 上下文。ExecuteStoreQueryAsync<Post> (“SELECT * FROM dbo。文章 WHERE Author = @author“， new SqlParameter (”@author“， userSuppliedAuthor) ) ;

[System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Design", "CA1006:DoNotNestGenericTypesInMemberSignatures")]
public virtual System.Threading.Tasks.Task<System.Data.Entity.Core.Objects.ObjectResult<TElement>> ExecuteStoreQueryAsync<TElement> (string commandText, System.Threading.CancellationToken cancellationToken, params object[] parameters);
abstract member ExecuteStoreQueryAsync : string * System.Threading.CancellationToken * obj[] -> System.Threading.Tasks.Task<System.Data.Entity.Core.Objects.ObjectResult<'Element>>
override this.ExecuteStoreQueryAsync : string * System.Threading.CancellationToken * obj[] -> System.Threading.Tasks.Task<System.Data.Entity.Core.Objects.ObjectResult<'Element>>

类型参数

TElement

结果序列的元素类型。

参数

commandText
String

用服务器的本机查询语言指定的查询。

cancellationToken
CancellationToken

等待 CancellationToken 任务完成时要观察的 。

parameters
Object[]

要用于查询的参数值。 如果使用输出参数，则在完全读取结果之前，这些参数的值将不可用。 这是由于 DbDataReader 的基本行为造成的，有关详细信息，请参阅 http://go.microsoft.com/fwlink/?LinkID=398589 。

返回

Task<ObjectResult<TElement>>

表示异步操作的任务。 任务结果包含 类型的 TElement 对象的枚举。

属性
SuppressMessageAttribute

注解

不支持对同一上下文实例执行多个活动操作。 使用“await”确保在此上下文上调用另一个方法之前已完成所有异步操作。

适用于

ExecuteStoreQueryAsync<TElement>(String, ExecutionOptions, CancellationToken, Object[])

直接对数据源异步执行查询，并返回类型化结果序列。 查询是使用服务器的本机查询语言（如 SQL）指定的。 上下文不跟踪结果，请使用指定实体集名称的重载来跟踪结果。

与任何接受 SQL 的 API 一样，必须参数化任何用户输入，以防止 SQL 注入攻击。 可以在 SQL 查询字符串中包含参数位置持有者，然后将参数值作为其他参数提供。 提供的任何参数值将自动转换为 DbParameter。 上下文。ExecuteStoreQueryAsync<Post> (“SELECT * FROM dbo。文章 WHERE Author = @p0“， userSuppliedAuthor) ;或者，还可以构造 DbParameter 并将其提供给 SqlQuery。 这样可以在 SQL 查询字符串中使用命名参数。 上下文。ExecuteStoreQueryAsync<Post> (“SELECT * FROM dbo。文章 WHERE Author = @author“， new SqlParameter (”@author“， userSuppliedAuthor) ) ;

[System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Design", "CA1006:DoNotNestGenericTypesInMemberSignatures")]
public virtual System.Threading.Tasks.Task<System.Data.Entity.Core.Objects.ObjectResult<TElement>> ExecuteStoreQueryAsync<TElement> (string commandText, System.Data.Entity.Core.Objects.ExecutionOptions executionOptions, System.Threading.CancellationToken cancellationToken, params object[] parameters);
abstract member ExecuteStoreQueryAsync : string * System.Data.Entity.Core.Objects.ExecutionOptions * System.Threading.CancellationToken * obj[] -> System.Threading.Tasks.Task<System.Data.Entity.Core.Objects.ObjectResult<'Element>>
override this.ExecuteStoreQueryAsync : string * System.Data.Entity.Core.Objects.ExecutionOptions * System.Threading.CancellationToken * obj[] -> System.Threading.Tasks.Task<System.Data.Entity.Core.Objects.ObjectResult<'Element>>

类型参数

TElement

结果序列的元素类型。

参数

commandText
String

用服务器的本机查询语言指定的查询。

executionOptions
ExecutionOptions

用于执行此查询的选项。

cancellationToken
CancellationToken

等待 CancellationToken 任务完成时要观察的 。

parameters
Object[]

要用于查询的参数值。 如果使用输出参数，则在完全读取结果之前，这些参数的值将不可用。 这是由于 DbDataReader 的基本行为造成的，有关详细信息，请参阅 http://go.microsoft.com/fwlink/?LinkID=398589 。

返回

Task<ObjectResult<TElement>>

表示异步操作的任务。 任务结果包含 类型的 TElement 对象的枚举。

属性
SuppressMessageAttribute

注解

不支持对同一上下文实例执行多个活动操作。 使用“await”确保在此上下文上调用另一个方法之前已完成所有异步操作。

适用于

ExecuteStoreQueryAsync<TElement>(String, String, ExecutionOptions, Object[])

直接对数据源异步执行查询，并返回类型化结果序列。 查询是使用服务器的本机查询语言（如 SQL）指定的。 如果指定了实体集名称，则上下文将跟踪结果。

与任何接受 SQL 的 API 一样，必须参数化任何用户输入，以防止 SQL 注入攻击。 可以在 SQL 查询字符串中包含参数位置持有者，然后将参数值作为其他参数提供。 提供的任何参数值将自动转换为 DbParameter。 上下文。ExecuteStoreQueryAsync<Post> (“SELECT * FROM dbo。文章 WHERE Author = @p0“， userSuppliedAuthor) ;或者，还可以构造 DbParameter 并将其提供给 SqlQuery。 这样可以在 SQL 查询字符串中使用命名参数。 上下文。ExecuteStoreQueryAsync<Post> (“SELECT * FROM dbo。文章 WHERE Author = @author“， new SqlParameter (”@author“， userSuppliedAuthor) ) ;

[System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Design", "CA1006:DoNotNestGenericTypesInMemberSignatures")]
public System.Threading.Tasks.Task<System.Data.Entity.Core.Objects.ObjectResult<TElement>> ExecuteStoreQueryAsync<TElement> (string commandText, string entitySetName, System.Data.Entity.Core.Objects.ExecutionOptions executionOptions, params object[] parameters);
member this.ExecuteStoreQueryAsync : string * string * System.Data.Entity.Core.Objects.ExecutionOptions * obj[] -> System.Threading.Tasks.Task<System.Data.Entity.Core.Objects.ObjectResult<'Element>>

类型参数

TElement

结果序列的元素类型。

参数

commandText
String

用服务器的本机查询语言指定的查询。

entitySetName
String

TResult 类型的实体集。 如果未提供实体集名称，则不会跟踪结果。

executionOptions
ExecutionOptions

用于执行此查询的选项。

parameters
Object[]

要用于查询的参数值。 如果使用输出参数，则在完全读取结果之前，这些参数的值将不可用。 这是由于 DbDataReader 的基本行为造成的，有关详细信息，请参阅 http://go.microsoft.com/fwlink/?LinkID=398589 。

返回

Task<ObjectResult<TElement>>

表示异步操作的任务。 任务结果包含 类型的 TElement 对象的枚举。

属性
SuppressMessageAttribute

注解

不支持对同一上下文实例执行多个活动操作。 使用“await”确保在此上下文上调用另一个方法之前已完成所有异步操作。

适用于

ExecuteStoreQueryAsync<TElement>(String, String, ExecutionOptions, CancellationToken, Object[])

直接对数据源异步执行查询，并返回类型化结果序列。 查询是使用服务器的本机查询语言（如 SQL）指定的。 如果指定了实体集名称，则上下文将跟踪结果。

与任何接受 SQL 的 API 一样，必须参数化任何用户输入，以防止 SQL 注入攻击。 可以在 SQL 查询字符串中包含参数位置持有者，然后将参数值作为其他参数提供。 提供的任何参数值将自动转换为 DbParameter。 上下文。ExecuteStoreQueryAsync<Post> (“SELECT * FROM dbo。文章 WHERE Author = @p0“， userSuppliedAuthor) ;或者，还可以构造 DbParameter 并将其提供给 SqlQuery。 这样可以在 SQL 查询字符串中使用命名参数。 上下文。ExecuteStoreQueryAsync<Post> (“SELECT * FROM dbo。文章 WHERE Author = @author“， new SqlParameter (”@author“， userSuppliedAuthor) ) ;

[System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Design", "CA1006:DoNotNestGenericTypesInMemberSignatures")]
public virtual System.Threading.Tasks.Task<System.Data.Entity.Core.Objects.ObjectResult<TElement>> ExecuteStoreQueryAsync<TElement> (string commandText, string entitySetName, System.Data.Entity.Core.Objects.ExecutionOptions executionOptions, System.Threading.CancellationToken cancellationToken, params object[] parameters);
abstract member ExecuteStoreQueryAsync : string * string * System.Data.Entity.Core.Objects.ExecutionOptions * System.Threading.CancellationToken * obj[] -> System.Threading.Tasks.Task<System.Data.Entity.Core.Objects.ObjectResult<'Element>>
override this.ExecuteStoreQueryAsync : string * string * System.Data.Entity.Core.Objects.ExecutionOptions * System.Threading.CancellationToken * obj[] -> System.Threading.Tasks.Task<System.Data.Entity.Core.Objects.ObjectResult<'Element>>

类型参数

TElement

结果序列的元素类型。

参数

commandText
String

用服务器的本机查询语言指定的查询。

entitySetName
String

TResult 类型的实体集。 如果未提供实体集名称，则不会跟踪结果。

executionOptions
ExecutionOptions

用于执行此查询的选项。

cancellationToken
CancellationToken

等待 CancellationToken 任务完成时要观察的 。

parameters
Object[]

要用于查询的参数值。 如果使用输出参数，则在完全读取结果之前，这些参数的值将不可用。 这是由于 DbDataReader 的基本行为造成的，有关详细信息，请参阅 http://go.microsoft.com/fwlink/?LinkID=398589 。

返回

Task<ObjectResult<TElement>>

表示异步操作的任务。 任务结果包含 类型的 TElement 对象的枚举。

属性
SuppressMessageAttribute

注解

不支持对同一上下文实例执行多个活动操作。 使用“await”确保在此上下文上调用另一个方法之前已完成所有异步操作。

适用于