DbDataReader.GetFieldValueAsync Yöntem

Tanım

Ad Alanı:

System.Data.Common

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Data.Common.dll

Belirtilen sütunun değerini istenen tür olarak zaman uyumsuz olarak alır.

Aşırı Yüklemeler

Name	Description
GetFieldValueAsync<T>(Int32)	Belirtilen sütunun değerini istenen tür olarak zaman uyumsuz olarak alır.
GetFieldValueAsync<T>(Int32, CancellationToken)	Belirtilen sütunun değerini istenen tür olarak zaman uyumsuz olarak alır.

GetFieldValueAsync<T>(Int32)

Kaynak:

DbDataReader.cs

Belirtilen sütunun değerini istenen tür olarak zaman uyumsuz olarak alır.

public:
generic <typename T>
 System::Threading::Tasks::Task<T> ^ GetFieldValueAsync(int ordinal);

public System.Threading.Tasks.Task<T> GetFieldValueAsync<T>(int ordinal);

member this.GetFieldValueAsync : int -> System.Threading.Tasks.Task<'T>

Public Function GetFieldValueAsync(Of T) (ordinal As Integer) As Task(Of T)

Tür Parametreleri

T

Döndürülecek değerin türü.

Parametreler

ordinal

Int32

Sıfır tabanlı sütun sıralı.

Döndürülenler

Task<T>

Belirtilen sütunun değerini içeren bir görev Result .

Ö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ıldı.

-veya-

Okunmaya hazır veri yok (örneğin, ilk Read() çağrılmamış veya döndürülmüştür false).

-veya-

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

-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.

InvalidCastException

Veritabanı tarafından döndürülen değer ile eşleşmiyor veya olarak oluşturulamıyor T.

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.

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.

GetFieldValueAsync<T>(Int32, CancellationToken)

Kaynak:

DbDataReader.cs

Belirtilen sütunun değerini istenen tür olarak zaman uyumsuz olarak alır.

public:
generic <typename T>
 virtual System::Threading::Tasks::Task<T> ^ GetFieldValueAsync(int ordinal, System::Threading::CancellationToken cancellationToken);

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

abstract member GetFieldValueAsync : int * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'T>
override this.GetFieldValueAsync : int * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'T>

Public Overridable Function GetFieldValueAsync(Of T) (ordinal As Integer, cancellationToken As CancellationToken) As Task(Of T)

Tür Parametreleri

T

Döndürülecek değerin türü.

Parametreler

ordinal

Int32

Sıfır tabanlı sütun sıralı.

cancellationToken

CancellationToken

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

Döndürülenler

Task<T>

Belirtilen sütunun değerini içeren bir görev Result .

Ö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ıldı.

-veya-

Okunmaya hazır veri yok (örneğin, ilk Read() çağrılmamış veya döndürülmüştür false).

-veya-

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

-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.

InvalidCastException

Veritabanı tarafından döndürülen değer ile eşleşmiyor veya olarak oluşturulamıyor T.

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 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.