DbDataReader.IsDBNullAsync Yöntem

Tanım

Ad Alanı:

System.Data.Common

Bütünleştirilmiş Kod:

System.Data.Common.dll

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

Aşırı Yüklemeler

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

IsDBNullAsync(Int32)

Kaynak:

DbDataReader.cs

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

public:
 System::Threading::Tasks::Task<bool> ^ IsDBNullAsync(int ordinal);

public System.Threading.Tasks.Task<bool> IsDBNullAsync (int ordinal);

member this.IsDBNullAsync : int -> System.Threading.Tasks.Task<bool>

Public Function IsDBNullAsync (ordinal As Integer) As Task(Of Boolean)

Parametreler

ordinal

Int32

Alınacak sıfır tabanlı sütun.

Döndürülenler

Task<Boolean>

Task<TResult> Belirtilen sütun değeri ile eşdeğerse DBNull veya false eşit değilse özelliği true olan Result 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üldü).

-veya-

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

-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

Sütun dizini aralık dışında.

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ıklarını ç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.

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

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 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 IsDBNull(Int32)özel durumlara bakın.

IsDBNullAsync(Int32, CancellationToken)

Kaynak:

DbDataReader.cs

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

public:
 virtual System::Threading::Tasks::Task<bool> ^ IsDBNullAsync(int ordinal, System::Threading::CancellationToken cancellationToken);

public virtual System.Threading.Tasks.Task<bool> IsDBNullAsync (int ordinal, System.Threading.CancellationToken cancellationToken);

abstract member IsDBNullAsync : int * System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>
override this.IsDBNullAsync : int * System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>

Public Overridable Function IsDBNullAsync (ordinal As Integer, cancellationToken As CancellationToken) As Task(Of Boolean)

Parametreler

ordinal

Int32

Alınacak sıfır tabanlı sütun.

cancellationToken

CancellationToken

Zaman uyumsuz işlemi iptal etmek için bir belirteç.

Döndürülenler

Task<Boolean>

Task<TResult> Belirtilen sütun değeri ile eşdeğerse DBNull veya false eşit değilse özelliği true olan Result 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üldü).

-veya-

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

-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

Sütun dizini aralık dışında.

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ıklarını ç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çirildiyse iptal edilen bir görevi de döndürür.

Zaman uyumsuz programlamayı destekleyen veri sağlayıcıları, zaman uyumsuz G/Ç işlemlerini kullanarak varsayılan uygulamayı 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 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 IsDBNull(Int32)özel durumlara bakın.