DbDataReader.GetFieldValueAsync Yöntem
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
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
- Kaynak:
- DbDataReader.cs
- 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
Belirtilen sütunun değerini içeren bir görev Result .
Özel durumlar
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.
Sütun dizini aralık dışında.
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.
Şunlara uygulanır
GetFieldValueAsync<T>(Int32, CancellationToken)
- Kaynak:
- DbDataReader.cs
- Kaynak:
- DbDataReader.cs
- 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
Belirtilen sütunun değerini içeren bir görev Result .
Özel durumlar
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.
Sütun dizini aralık dışında.
Veritabanı tarafından döndürülen değer eşleşmiyor veya olarak değiştirilemiyor T.
İ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.
