DbDataReader.GetFieldValueAsync Yöntem

Tanım

Ad Alanı:

System.Data.Common

Bütünleştirilmiş Kod:

System.Data.Common.dll

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

Aşırı Yüklemeler

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

GetFieldValueAsync<T>(Int32)

Kaynak:

DbDataReader.cs

Belirtilen sütunun değerini zaman uyumsuz olarak istenen tür 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 okuyucu, veri alma sırasında kapatıldı.

-veya-

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

-veya-

Daha önce okunan bir sütunu sıralı modda okumayı denedim.

-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 eşleşmiyor veya olarak değiştirilemiyor 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 duruma gelmelidir ve yöntemin zaman uyumlu sürümünün çağrılması çağrılan 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ı 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 zaman uyumsuz olarak istenen tür 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 okuyucu, veri alma sırasında kapatıldı.

-veya-

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

-veya-

Daha önce okunan bir sütunu sıralı modda okumayı denedim.

-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 eşleşmiyor veya olarak değiştirilemiyor 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 duruma gelmelidir ve yöntemin zaman uyumlu sürümünün çağrılması çağrılan 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ı iş parçacığını engelleme olasılığı vardır. Varsayılan uygulama, zaten iptal edilmiş bir iptal belirtecinden geçildiyse 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 iptal edilmesi isteğinde bulunmak 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.