共用方式為


SqlCommand.ExecuteXmlReaderAsync 方法

定義

多載

ExecuteXmlReaderAsync()

ExecuteXmlReader() 異步版本,它會將 傳送 CommandTextConnection 並建置 XmlReader 物件。

例外狀況將經由傳回的 Task 物件回報。

ExecuteXmlReaderAsync(CancellationToken)

ExecuteXmlReader() 異步版本,它會將 傳送 CommandTextConnection 並建置 XmlReader 物件。

取消語彙基元可用於要求在命令逾時之前捨棄作業。 例外狀況將經由傳回的 Task 物件回報。

ExecuteXmlReaderAsync()

ExecuteXmlReader() 異步版本,它會將 傳送 CommandTextConnection 並建置 XmlReader 物件。

例外狀況將經由傳回的 Task 物件回報。

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當設定Stream為 時Value,使用了 BinaryVarBinary 以外的 。 如需串流的詳細資訊,請參閱 SqlClient 串流支援

-或-

SqlDbType當 設定TextReader為 時Value,會使用 CharNCharNVarCharVarCharXml 以外的 。

-或-

SqlDbType當設定XmlReader為 時Value,會使用 Xml 以外的 。

在工作完成前,對同一個執行個體呼叫 ExecuteScalarAsync(CancellationToken) 不止一次。

-或-

在串流作業期間已關閉或卸除的 SqlConnection。 如需串流的詳細資訊,請參閱 SqlClient 串流支援

SQL Server 於執行命令文字時傳回錯誤。

-或-

串流作業期間發生逾時。 如需串流的詳細資訊,請參閱 SqlClient 串流支援

在串流作業期間,XmlReaderTextReader 對象中Stream發生錯誤。 如需串流的詳細資訊,請參閱 SqlClient 串流支援

XmlReaderStream串流作業期間,或 TextReader 物件已關閉。 如需串流的詳細資訊,請參閱 SqlClient 串流支援

備註

這個方法所傳回的 XmlReader 不支援異步操作。 如需 .NET Framework Data Provider for SQL Server 中異步程式設計的詳細資訊,請參閱異步程序設計

注意

對於伺服器上長時間執行的查詢,請考慮使用 ExecuteXmlReader ,因為透過取消令牌取消查詢的已知問題。 此外,請考慮使用 Cancel 方法來取消執行。

適用於

ExecuteXmlReaderAsync(CancellationToken)

ExecuteXmlReader() 異步版本,它會將 傳送 CommandTextConnection 並建置 XmlReader 物件。

取消語彙基元可用於要求在命令逾時之前捨棄作業。 例外狀況將經由傳回的 Task 物件回報。

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當設定Stream為 時Value,使用了 BinaryVarBinary 以外的 。 如需串流的詳細資訊,請參閱 SqlClient 串流支援

-或-

SqlDbType當 設定TextReader為 時Value,會使用 CharNCharNVarCharVarCharXml 以外的 。

-或-

SqlDbType當設定XmlReader為 時Value,會使用 Xml 以外的 。

在工作完成前,對同一個執行個體呼叫 ExecuteScalarAsync(CancellationToken) 不止一次。

-或-

在串流作業期間已關閉或卸除的 SqlConnection。 如需串流的詳細資訊,請參閱 SqlClient 串流支援

SQL Server 於執行命令文字時傳回錯誤。

-或-

串流作業期間發生逾時。 如需串流的詳細資訊,請參閱 SqlClient 串流支援

在串流作業期間,XmlReaderTextReader 對象中Stream發生錯誤。 如需串流的詳細資訊,請參閱 SqlClient 串流支援

XmlReaderStream串流作業期間,或 TextReader 物件已關閉。 如需串流的詳細資訊,請參閱 SqlClient 串流支援

備註

這個方法所傳回的 XmlReader 不支援異步操作。 如需 .NET Framework Data Provider for SQL Server 中異步程式設計的詳細資訊,請參閱異步程序設計

適用於