SqlCommand.ExecuteXmlReaderAsync 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
啟動非同步執行由此 SqlCommand 描述的 Transact-SQL 語句或儲存程序，並將結果以 XmlReader 物件形式回傳。
多載
| 名稱 | Description |
|---|---|
| ExecuteXmlReaderAsync() |
一個非同步版本的 ExecuteXmlReader()，將 傳送 CommandText 到 並 Connection 建立一個 XmlReader 物件。 例外將透過回傳的任務物件回報。 |
| ExecuteXmlReaderAsync(CancellationToken) |
一個非同步版本的 ExecuteXmlReader()，將 傳送 CommandText 到 並 Connection 建立一個 XmlReader 物件。 取消標記可用來請求在指令逾時前放棄操作。 例外將透過回傳的任務物件回報。 |
ExecuteXmlReaderAsync()
一個非同步版本的 ExecuteXmlReader()，將 傳送 CommandText 到 並 Connection 建立一個 XmlReader 物件。
例外將透過回傳的任務物件回報。
public:
System::Threading::Tasks::Task<System::Xml::XmlReader ^> ^ ExecuteXmlReaderAsync();public System.Threading.Tasks.Task<System.Xml.XmlReader> ExecuteXmlReaderAsync();member this.ExecuteXmlReaderAsync : unit -> System.Threading.Tasks.Task<System.Xml.XmlReader>Public Function ExecuteXmlReaderAsync () As Task(Of XmlReader)傳回
一個代表非同步操作的任務。
例外狀況
當 設定為 SqlDbType時，會使用除 Binary 或 VarBinary 以外的 。ValueStream 欲了解更多串流資訊，請參閱 SqlClient 串流支援。
-或-
SqlDbType除了 Char、NChar、NVarChar、VarChar 或 Xml，當 設定為 時，會使用其他 Char、Value、NVarChar、TextReader 或 Xml。
-或-
在同一 ExecuteScalarAsync(CancellationToken) 個實例呼叫超過一次，任務才完成。
-或-
在 SqlConnection 串流操作中關閉或掉落。 欲了解更多串流資訊，請參閱 SqlClient 串流支援。
-或-
Context Connection=true 在連接字串中指定。
在串流操作中，物件或 發生StreamXmlReaderTextReader錯誤。 欲了解更多串流資訊，請參閱 SqlClient 串流支援。
Stream該 ， XmlReader 或TextReader物件在串流操作中被關閉。 欲了解更多串流資訊，請參閱 SqlClient 串流支援。
備註
此方法回傳的 XmlReader 不支援非同步操作。
欲了解更多關於.NET框架Data Provider for SQL Server 非同步程式設計的資訊，請參見 非同步程式設計。
此方法在任務中儲存所有非使用例外，該方法的同步對應程式可拋出這些例外。 如果回傳的任務中儲存了例外，該例外會在等待任務時拋出。 使用例外錯誤，例如 ArgumentException，仍會同步拋出。 關於儲存的例外，請參見由 ExecuteXmlReader()拋出的例外。
另請參閱
適用於
ExecuteXmlReaderAsync(CancellationToken)
一個非同步版本的 ExecuteXmlReader()，將 傳送 CommandText 到 並 Connection 建立一個 XmlReader 物件。
取消標記可用來請求在指令逾時前放棄操作。 例外將透過回傳的任務物件回報。
public:
System::Threading::Tasks::Task<System::Xml::XmlReader ^> ^ ExecuteXmlReaderAsync(System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.Task<System.Xml.XmlReader> ExecuteXmlReaderAsync(System.Threading.CancellationToken cancellationToken);member this.ExecuteXmlReaderAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Xml.XmlReader>Public Function ExecuteXmlReaderAsync (cancellationToken As CancellationToken) As Task(Of XmlReader)參數
- cancellationToken
- CancellationToken
取消指示。
傳回
一個代表非同步操作的任務。
例外狀況
當 設定為 SqlDbType時，會使用除 Binary 或 VarBinary 以外的 。ValueStream 欲了解更多串流資訊，請參閱 SqlClient 串流支援。
-或-
SqlDbType除了 Char、NChar、NVarChar、VarChar 或 Xml，當 設定為 時，會使用其他 Char、Value、NVarChar、TextReader 或 Xml。
-或-
在同一 ExecuteScalarAsync(CancellationToken) 個實例呼叫超過一次，任務才完成。
-或-
在 SqlConnection 串流操作中關閉或掉落。 欲了解更多串流資訊，請參閱 SqlClient 串流支援。
-或-
Context Connection=true 在連接字串中指定。
在串流操作中，物件或 發生StreamXmlReaderTextReader錯誤。 欲了解更多串流資訊，請參閱 SqlClient 串流支援。
Stream該 ， XmlReader 或TextReader物件在串流操作中被關閉。 欲了解更多串流資訊，請參閱 SqlClient 串流支援。
取消令牌也被取消了。 此例外會儲存在回傳的任務中。
備註
此方法回傳的 XmlReader 不支援非同步操作。
欲了解更多關於.NET框架Data Provider for SQL Server 非同步程式設計的資訊，請參見 非同步程式設計。
此方法在任務中儲存所有非使用例外，該方法的同步對應程式可拋出這些例外。 如果回傳的任務中儲存了例外，該例外會在等待任務時拋出。 使用例外錯誤，例如 ArgumentException，仍會同步拋出。 關於儲存的例外，請參見由 ExecuteXmlReader()拋出的例外。