ObjectContext.ExecuteStoreQueryAsync 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
多載
| 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 。
傳回
代表非同步作業的工作。
工作結果包含 類型的 TElement 物件列舉。
- 屬性
備註
不支援相同內容實例上的多個作用中作業。 使用 '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 。
傳回
代表非同步作業的工作。
工作結果包含 類型的 TElement 物件列舉。
- 屬性
備註
不支援相同內容實例上的多個作用中作業。 使用 '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 。
傳回
代表非同步作業的工作。
工作結果包含 類型的 TElement 物件列舉。
- 屬性
備註
不支援相同內容實例上的多個作用中作業。 使用 '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 。
傳回
代表非同步作業的工作。
工作結果包含 類型的 TElement 物件列舉。
- 屬性
備註
不支援相同內容實例上的多個作用中作業。 使用 '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 。
傳回
代表非同步作業的工作。
工作結果包含 類型的 TElement 物件列舉。
- 屬性
備註
不支援相同內容實例上的多個作用中作業。 使用 '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 以取得詳細資料。
傳回
代表非同步作業的工作。
工作結果包含 類型的 TElement 物件列舉。
- 屬性
備註
不支援相同內容實例上的多個作用中作業。 使用 'await' 來確保任何非同步作業都已完成，再呼叫此內容上的另一個方法。
