DataReaderExtensions.IsDBNullAsync Yöntem

Tanım

Ad Alanı:

System.Data

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Data.Common.dll

Kaynak:

DataReaderExtensions.cs

Zaman uyumsuz olarak, sütunun var olmayan veya eksik değerler içerdiğini belirten bir değer alır.

public static System.Threading.Tasks.Task<bool> IsDBNullAsync(this System.Data.Common.DbDataReader reader, string name, System.Threading.CancellationToken cancellationToken = default);

static member IsDBNullAsync : System.Data.Common.DbDataReader * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>

<Extension()>
Public Function IsDBNullAsync (reader As DbDataReader, name As String, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Boolean)

Parametreler

reader

DbDataReader

Sütun değerini almak için veri okuyucu.

name

String

Sütunun adı.

cancellationToken

CancellationToken

Zaman uyumsuz işlemi iptal etmek için isteğe bağlı bir belirteç.

Döndürülenler

Task<Boolean>

Task<TResult> Belirtilen sütun değeri ile eşdeğerse Result veya true değilse özelliği DBNull olan false bir.

Özel durumlar

InvalidOperationException

Veri alma sırasında bağlantı bırakıldı veya kapatıldı.

-veya-

Veri alma sırasında veri okuyucu kapatılır.

-veya-

Okunmaya hazır veri yok (örneğin, ilk Read() çağrılmadı veya false döndürülmedi).

-veya-

Daha önce okunan bir sütunu sıralı modda okumaya çalışıyor.

-veya-

Devam eden zaman uyumsuz bir işlem vardı. Bu, bir akış okunurken çağrılabilecekleri için sıralı modda çalışırken tüm Get* yöntemleri için geçerlidir.

IndexOutOfRangeException

Belirtilen ad geçerli bir sütun adı değil.

OperationCanceledException

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

Açıklamalar

Bu zaman uyumsuz yöntem yalnızca okuyucu sıralı modda oluşturulduğunda çağıran iş parçacığını engellememek için gereklidir.

Sıralı mod belirtilmezse, ReadAsync her tamamlandığında tüm sütun değerleri bellekte kullanılabilir hale gelmelidir ve yöntemin zaman uyumlu sürümünü çağırmak çağıran iş parçacığını engellememelidir.

Bu zaman uyumsuz yöntemin varsayılan uygulaması, zaman uyumlu karşılık gelenini çağırır ve tamamlanmış bir Görev döndürür ve çağrılan iş parçacığını engelleme olasılığı vardır. Varsayılan uygulama, zaten iptal edilmiş bir iptal belirteci geçirilirse iptal edilmiş bir görev de döndürür.

Zaman uyumsuz programlamayı destekleyen veri sağlayıcıları, zaman uyumsuz G/Ç işlemlerini kullanarak varsayılan inmplementation'ı geçersiz kılmalıdır.

Bu yöntem, işlemin erken iptalini istemek için kullanılabilecek bir iptal belirteci kabul eder. Uygulamalar bu isteği yoksayabilir.

Döndürülen Görev henüz tamamlanmamışken DbDataReader nesnesinin diğer yöntemleri ve özellikleri çağrılmamalıdır.

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 IsDBNull(DbDataReader, String)oluşan özel durumlara bakın.