ObjectContext.ExecuteStoreQueryAsync 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
多載
| 名稱 | Description |
|---|---|
| ExecuteStoreQueryAsync<TElement>(String, Object[]) |
非同步直接對資料來源執行查詢，並回傳一連串已打型的結果。 查詢是使用伺服器原生查詢語言（如 SQL）來指定。 結果不會被上下文追蹤，請使用指定實體集合名稱的超載功能來追蹤結果。 和任何接受 SQL 的 API 一樣，必須對使用者輸入進行參數化，以防止 SQL 注入攻擊。 你可以在 SQL 查詢字串中加入參數佔位符，然後以參數值作為額外參數。 你提供的任何參數值都會自動轉換成 DbParameter。 背景說明。ExecuteStoreQueryAsync<Post>（“SELECT * FROM dbo.文章 作者 = @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.文章 作者 = @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.文章 作者 = @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.文章 作者 = @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.文章 作者 = @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.文章 作者 = @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.文章 作者 = @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 為 的物件的枚舉。
- 屬性
備註
不支援在同一上下文實例上進行多個主動操作。 在此上下文中呼叫其他方法前，請使用「wait」以確保所有非同步操作已完成。
適用於
ExecuteStoreQueryAsync<TElement>(String, ExecutionOptions, Object[])
非同步直接對資料來源執行查詢，並回傳一連串已打型的結果。 查詢是使用伺服器原生查詢語言（如 SQL）來指定。 結果不會被上下文追蹤，請使用指定實體集合名稱的超載功能來追蹤結果。
和任何接受 SQL 的 API 一樣，必須對使用者輸入進行參數化，以防止 SQL 注入攻擊。 你可以在 SQL 查詢字串中加入參數佔位符，然後以參數值作為額外參數。 你提供的任何參數值都會自動轉換成 DbParameter。 背景說明。ExecuteStoreQueryAsync<Post>（“SELECT * FROM dbo.文章 作者 = @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 為 的物件的枚舉。
- 屬性
備註
不支援在同一上下文實例上進行多個主動操作。 在此上下文中呼叫其他方法前，請使用「wait」以確保所有非同步操作已完成。
適用於
ExecuteStoreQueryAsync<TElement>(String, CancellationToken, Object[])
非同步直接對資料來源執行查詢，並回傳一連串已打型的結果。 查詢是使用伺服器原生查詢語言（如 SQL）來指定。 結果不會被上下文追蹤，請使用指定實體集合名稱的超載功能來追蹤結果。
和任何接受 SQL 的 API 一樣，必須對使用者輸入進行參數化，以防止 SQL 注入攻擊。 你可以在 SQL 查詢字串中加入參數佔位符，然後以參數值作為額外參數。 你提供的任何參數值都會自動轉換成 DbParameter。 背景說明。ExecuteStoreQueryAsync<Post>（“SELECT * FROM dbo.文章 作者 = @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
A CancellationToken 在等待任務完成時觀察。
- parameters
- Object[]
查詢時要用的參數值。 若使用輸出參數，其值在結果完整讀取後無法取得。 這是因為 DbDataReader 的底層行為，詳情請見 http://go.microsoft.com/fwlink/?LinkID=398589 。
傳回
一個代表非同步操作的任務。
任務結果包含了型別 TElement 為 的物件的枚舉。
- 屬性
備註
不支援在同一上下文實例上進行多個主動操作。 在此上下文中呼叫其他方法前，請使用「wait」以確保所有非同步操作已完成。
適用於
ExecuteStoreQueryAsync<TElement>(String, ExecutionOptions, CancellationToken, Object[])
非同步直接對資料來源執行查詢，並回傳一連串已打型的結果。 查詢是使用伺服器原生查詢語言（如 SQL）來指定。 結果不會被上下文追蹤，請使用指定實體集合名稱的超載功能來追蹤結果。
和任何接受 SQL 的 API 一樣，必須對使用者輸入進行參數化，以防止 SQL 注入攻擊。 你可以在 SQL 查詢字串中加入參數佔位符，然後以參數值作為額外參數。 你提供的任何參數值都會自動轉換成 DbParameter。 背景說明。ExecuteStoreQueryAsync<Post>（“SELECT * FROM dbo.文章 作者 = @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
A CancellationToken 在等待任務完成時觀察。
- parameters
- Object[]
查詢時要用的參數值。 若使用輸出參數，其值在結果完整讀取後無法取得。 這是因為 DbDataReader 的底層行為，詳情請見 http://go.microsoft.com/fwlink/?LinkID=398589 。
傳回
一個代表非同步操作的任務。
任務結果包含了型別 TElement 為 的物件的枚舉。
- 屬性
備註
不支援在同一上下文實例上進行多個主動操作。 在此上下文中呼叫其他方法前，請使用「wait」以確保所有非同步操作已完成。
適用於
ExecuteStoreQueryAsync<TElement>(String, String, ExecutionOptions, Object[])
非同步直接對資料來源執行查詢，並回傳一連串已打型的結果。 查詢是使用伺服器原生查詢語言（如 SQL）來指定。 若指定實體集合名稱，結果會依上下文追蹤。
和任何接受 SQL 的 API 一樣，必須對使用者輸入進行參數化，以防止 SQL 注入攻擊。 你可以在 SQL 查詢字串中加入參數佔位符，然後以參數值作為額外參數。 你提供的任何參數值都會自動轉換成 DbParameter。 背景說明。ExecuteStoreQueryAsync<Post>（“SELECT * FROM dbo.文章 作者 = @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 為 的物件的枚舉。
- 屬性
備註
不支援在同一上下文實例上進行多個主動操作。 在此上下文中呼叫其他方法前，請使用「wait」以確保所有非同步操作已完成。
適用於
ExecuteStoreQueryAsync<TElement>(String, String, ExecutionOptions, CancellationToken, Object[])
非同步直接對資料來源執行查詢，並回傳一連串已打型的結果。 查詢是使用伺服器原生查詢語言（如 SQL）來指定。 若指定實體集合名稱，結果會依上下文追蹤。
和任何接受 SQL 的 API 一樣，必須對使用者輸入進行參數化，以防止 SQL 注入攻擊。 你可以在 SQL 查詢字串中加入參數佔位符，然後以參數值作為額外參數。 你提供的任何參數值都會自動轉換成 DbParameter。 背景說明。ExecuteStoreQueryAsync<Post>（“SELECT * FROM dbo.文章 作者 = @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
A CancellationToken 在等待任務完成時觀察。
- parameters
- Object[]
查詢時要用的參數值。 若使用輸出參數，其值在結果完整讀取後無法取得。 這是因為 DbDataReader 的底層行為，詳情請見 http://go.microsoft.com/fwlink/?LinkID=398589 。
傳回
一個代表非同步操作的任務。
任務結果包含了型別 TElement 為 的物件的枚舉。
- 屬性
備註
不支援在同一上下文實例上進行多個主動操作。 在此上下文中呼叫其他方法前，請使用「wait」以確保所有非同步操作已完成。
