SqlCommand.ExecuteXmlReaderAsync Yöntem

Tanım

Ad Alanı:

System.Data.SqlClient

Bütünleştirilmiş Kod:

System.Data.dll

Bunun SqlCommand tarafından açıklanan Transact-SQL deyiminin veya saklı yordamın zaman uyumsuz yürütülmesini başlatır ve sonuçları bir XmlReader nesne olarak döndürür.

Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.

Aşırı Yüklemeler

Veri Akışı Adı	Description
ExecuteXmlReaderAsync()	öğesine gönderen ExecuteXmlReader()CommandText ve bir nesnesi oluşturan zaman uyumsuz sürümüConnectionXmlReader. Özel durumlar döndürülen Görev nesnesi aracılığıyla bildirilir. Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.
ExecuteXmlReaderAsync(CancellationToken)	öğesine gönderen ExecuteXmlReader()CommandText ve bir nesnesi oluşturan zaman uyumsuz sürümüConnectionXmlReader. The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. Exceptions will be reported via the returned Task object. <p>For new development, use <a href="/sql/connect/ado-net/introduction-microsoft-data-sqlclient-namespace">Microsoft.Data.SqlClient</a>. This page documents System.Data.SqlClient.</p>

ExecuteXmlReaderAsync()

öğesine gönderen ExecuteXmlReader()CommandText ve bir nesnesi oluşturan zaman uyumsuz sürümüConnectionXmlReader.

Özel durumlar döndürülen Görev nesnesi aracılığıyla bildirilir.

Yeni geliştirme için Microsoft kullanın. Data.SqlClient. Bu sayfada System.Data.SqlClient belgelemektedir.

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)

Döndürülenler

Task<XmlReader>

Zaman uyumsuz işlemi temsil eden bir görev.

Özel durumlar

InvalidCastException

SqlDbType olarak ayarlandığında İkili veya Value dışında bir değer kullanıldıStream. Akış hakkında daha fazla bilgi için bkz. SqlClient Akış Desteği.

-veya-

SqlDbType Olarak ayarlandığında Char, NChar, NVarChar, VarChar veya Value dışında bir değer kullanıldıTextReader.

-veya-

SqlDbType olarak ayarlandığında Value dışında bir değer kullanıldıXmlReader.

InvalidOperationException

Görev tamamlanmadan önce aynı örnek için birden çok kez çağrılması ExecuteScalarAsync(CancellationToken) .

-veya-

Akış SqlConnection işlemi sırasında kapatılan veya bırakılan. Akış hakkında daha fazla bilgi için bkz. SqlClient Akış Desteği.

-veya-

Context Connection=true bağlantı dizesi belirtilir.

SqlException

SQL Server komut metni yürütülürken bir hata döndürdü.

-veya-

Akış işlemi sırasında zaman aşımı oluştu. Akış hakkında daha fazla bilgi için bkz. SqlClient Akış Desteği.

IOException

Akış işlemi sırasında bir Streamveya XmlReaderTextReader nesnesinde hata oluştu. Akış hakkında daha fazla bilgi için bkz. SqlClient Akış Desteği.

ObjectDisposedException

bir Streamakış işlemi sırasında , XmlReader veya TextReader nesnesi kapatıldı. Akış hakkında daha fazla bilgi için bkz. SqlClient Akış Desteği.

Açıklamalar

Bu yöntem tarafından döndürülen XmlReader zaman uyumsuz işlemleri desteklemez.

SQL Server için .NET Framework Veri Sağlayıcısı zaman uyumsuz programlama hakkında daha fazla bilgi için bkz. Asynchronous Programming.

Bu yöntem, yöntemin zaman uyumlu karşılık geleninin oluşturabileceği tüm kullanım dışı özel durumları döndürdüğü görevde depolar. Döndürülen görevde bir özel durum depolanırsa, görev beklendiğinde bu özel durum oluşturulur. ArgumentExceptiongibi kullanım özel durumları hâlâ eşzamanlı olarak fırlatılır. Depolanan özel durumlar için tarafından ExecuteXmlReader()oluşan özel durumlara bakın.

Ayrıca bkz.

• ADO.NET’e Genel Bakış

ExecuteXmlReaderAsync(CancellationToken)

öğesine gönderen ExecuteXmlReader()CommandText ve bir nesnesi oluşturan zaman uyumsuz sürümüConnectionXmlReader.

      The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. Exceptions will be reported via the returned Task object.

      <p>For new development, use <a href="/sql/connect/ado-net/introduction-microsoft-data-sqlclient-namespace">Microsoft.Data.SqlClient</a>. This page documents System.Data.SqlClient.</p>

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)

Parametreler

cancellationToken

CancellationToken

İptal talimatı.

Döndürülenler

Task<XmlReader>

Zaman uyumsuz işlemi temsil eden bir görev.

Özel durumlar

InvalidCastException

SqlDbType olarak ayarlandığında İkili veya Value dışında bir değer kullanıldıStream. Akış hakkında daha fazla bilgi için bkz. SqlClient Akış Desteği.

-veya-

SqlDbType Olarak ayarlandığında Char, NChar, NVarChar, VarChar veya Value dışında bir değer kullanıldıTextReader.

-veya-

SqlDbType olarak ayarlandığında Value dışında bir değer kullanıldıXmlReader.

InvalidOperationException

Görev tamamlanmadan önce aynı örnek için birden çok kez çağrılması ExecuteScalarAsync(CancellationToken) .

-veya-

Akış SqlConnection işlemi sırasında kapatılan veya bırakılan. Akış hakkında daha fazla bilgi için bkz. SqlClient Akış Desteği.

-veya-

Context Connection=true bağlantı dizesi belirtilir.

SqlException

SQL Server komut metni yürütülürken bir hata döndürdü.

-veya-

Akış işlemi sırasında zaman aşımı oluştu. Akış hakkında daha fazla bilgi için bkz. SqlClient Akış Desteği.

IOException

Akış işlemi sırasında bir Streamveya XmlReaderTextReader nesnesinde hata oluştu. Akış hakkında daha fazla bilgi için bkz. SqlClient Akış Desteği.

ObjectDisposedException

bir Streamakış işlemi sırasında , XmlReader veya TextReader nesnesi kapatıldı. Akış hakkında daha fazla bilgi için bkz. SqlClient Akış Desteği.

OperationCanceledException

İptal belirteci iptal edildi. Bu özel durum, döndürülen görevde depolanır.

Açıklamalar

Bu yöntem tarafından döndürülen XmlReader zaman uyumsuz işlemleri desteklemez.

SQL Server için .NET Framework Veri Sağlayıcısı zaman uyumsuz programlama hakkında daha fazla bilgi için bkz. Asynchronous Programming.

Bu yöntem, yöntemin zaman uyumlu karşılık geleninin oluşturabileceği tüm kullanım dışı özel durumları döndürdüğü görevde depolar. Döndürülen görevde bir özel durum depolanırsa, görev beklendiğinde bu özel durum oluşturulur. ArgumentExceptiongibi kullanım özel durumları hâlâ eşzamanlı olarak fırlatılır. Depolanan özel durumlar için tarafından ExecuteXmlReader()oluşan özel durumlara bakın.

Ayrıca bkz.

• ADO.NET’e Genel Bakış