SqlCommand.ExecuteXmlReaderAsync Yöntem

Tanım

Ad Alanı:

System.Data.SqlClient

Bütünleştirilmiş Kod:

System.Data.dll

Paket:

System.Data.SqlClient v4.8.6

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

Aşırı Yüklemeler

ExecuteXmlReaderAsync()	öğesini öğesine gönderen ConnectionCommandText ve bir nesnesi oluşturan zaman uyumsuz sürümüExecuteXmlReader()XmlReader. Özel durumlar döndürülen Görev nesnesi ile bildirilir.
ExecuteXmlReaderAsync(CancellationToken)	öğesini öğesine gönderen ConnectionCommandText ve bir nesnesi oluşturan zaman uyumsuz sürümüExecuteXmlReader()XmlReader. İptali belirteci, işlem komut zaman aşımı dolmadan işlemin iptal edilmesini istemek için kullanılabilir. Özel durumlar döndürülen Görev nesnesi ile bildirilir.

ExecuteXmlReaderAsync()

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

Özel durumlar döndürülen Görev nesnesi ile bildirilir.

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 Streamİkili veya VarBinary dışında bir değer kullanıldıValue. Akış hakkında daha fazla bilgi için bkz . SqlClient Akış Desteği.

-veya-

SqlDbType olarak ayarlandığında TextReaderChar, NChar, NVarChar, VarChar veya Xml dışında bir değer kullanıldıValue.

-veya-

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

InvalidOperationException

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

-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=truebağlantı dizesi belirtilir.

SqlException

SQL Server komut metnini yürütü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

, StreamXmlReader veya TextReader nesnesi bir akış işlemi sırasında 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ı'nda zaman uyumsuz programlama hakkında daha fazla bilgi için bkz. Zaman Uyumsuz Programlama.

Bu yöntem, yöntemin zaman uyumlu karşılık geleninin atabileceği tüm kullanım dışı özel durumları döndürdüğü görevde depolar. Döndürülen görevde bir özel durum depolanıyorsa, görev beklenirken bu özel durum oluşturulur. gibi ArgumentExceptionkullanım özel durumları yine de zaman uyumlu olarak oluşturulur. Depolanan özel durumlar için tarafından oluşan ExecuteXmlReader()özel durumlara bakın.

Ayrıca bkz.

• ADO.NET’e Genel Bakış

ExecuteXmlReaderAsync(CancellationToken)

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

İptali belirteci, işlem komut zaman aşımı dolmadan işlemin iptal edilmesini istemek için kullanılabilir. Özel durumlar döndürülen Görev nesnesi ile bildirilir.

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 yönergesi.

Döndürülenler

Task<XmlReader>

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

Özel durumlar

InvalidCastException

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

-veya-

SqlDbType olarak ayarlandığında TextReaderChar, NChar, NVarChar, VarChar veya Xml dışında bir değer kullanıldıValue.

-veya-

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

InvalidOperationException

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

-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=truebağlantı dizesi belirtilir.

SqlException

SQL Server komut metnini yürütü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

, StreamXmlReader veya TextReader nesnesi bir akış işlemi sırasında 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ı'nda zaman uyumsuz programlama hakkında daha fazla bilgi için bkz. Zaman Uyumsuz Programlama.

Bu yöntem, yöntemin zaman uyumlu karşılık geleninin atabileceği tüm kullanım dışı özel durumları döndürdüğü görevde depolar. Döndürülen görevde bir özel durum depolanıyorsa, görev beklenirken bu özel durum oluşturulur. gibi ArgumentExceptionkullanım özel durumları yine de zaman uyumlu olarak oluşturulur. Depolanan özel durumlar için tarafından oluşan ExecuteXmlReader()özel durumlara bakın.

Ayrıca bkz.

• ADO.NET’e Genel Bakış