SqlDataReader.GetFieldValueAsync<T>(Int32, CancellationToken) Yöntem

Tanım

Ad Alanı:

System.Data.SqlClient

Bütünleştirilmiş Kod:

System.Data.SqlClient.dll

Paket:

System.Data.SqlClient v4.8.6

Belirtilen sütunun değerini zaman uyumsuz olarak tür olarak alır. GetFieldValue<T>(Int32) bu yöntemin zaman uyumlu sürümüdür.

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

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

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

Public Overrides Function GetFieldValueAsync(Of T) (i As Integer, cancellationToken As CancellationToken) As Task(Of T)

Tür Parametreleri

T

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

Parametreler

i

Int32

Alınacak sütun.

cancellationToken

CancellationToken

İşlemlerin iptal edilmesi gerektiğini belirten bir bildirim yayan iptal yönergesi. Bu, iptali garanti etmez. ayarı CancellationToken.None , bu yöntemi ile IsDBNull(Int32)eşdeğer hale getirir. Döndürülen görev iptal edildi olarak işaretlenmelidir.

Döndürülenler

Task<T>

Döndürülen tür nesnesi.

Özel durumlar

InvalidOperationException

Veri alma sırasında bağlantı düşer veya kapatılır.

SqlDataReader, veri alma sırasında kapatılır.

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

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

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.

Context Connection=truebağlantı dizesi belirtilir.

IndexOutOfRangeException

Var olmayan bir sütun okunmaya çalışılıyor.

SqlNullValueException

Sütunun değeri null ()IsDBNull(Int32) == true idi ve SQL olmayan bir tür alınıyordu.

InvalidCastException

TSQL Server tarafından döndürülen türle eşleşmiyor veya yayınlanamaz.

OperationCanceledException

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

Açıklamalar

T aşağıdaki türlerden biri olabilir:

Boole	Bayt	Char	DateTime
DateTimeOffset	Ondalık	Çift	Float
Guid	Int16	Int32	Int64
Sqlboolean	Sqlbyte	Sqldatetime	Sqldecimal
Sqldouble	Sqlguid	SqlInt16	Sqlınt32
SqlInt64	Sqlmoney	Sqlsingle	Sqlstring
Dize	UDT, ile SqlUserDefinedTypeAttributeişaretlenmiş herhangi bir CLR türü olabilir.

Daha fazla bilgi için bkz . SqlClient Akış Desteği.