SqlDataReader.GetFieldValueAsync<T>(Int32, CancellationToken) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft asynchron den Wert der angegebenen Spalte als Typ ab. GetFieldValue<T>(Int32) ist die synchrone Version dieser Methode.
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)Typparameter
- T
Der Typ des zurückzugebenden Werts.
Parameter
- i
- Int32
Die abzurufende Spalte.
- cancellationToken
- CancellationToken
Die Abbruchanweisung, die eine Benachrichtigung verteilt, dass Vorgänge abgebrochen werden sollen. Dies garantiert die Stornierung nicht. Eine Einstellung, die CancellationToken.None diese Methode entspricht IsDBNull(Int32). Der zurückgegebene Vorgang muss als abgebrochen markiert werden.
Gibt zurück
Das zurückgegebene Typobjekt.
Ausnahmen
Die Verbindung wird während des Datenabrufs abgebrochen oder geschlossen.
Der SqlDataReader Vorgang wird während des Datenabrufs geschlossen.
Es sind keine Daten zum Lesen bereit (z. B. wurde der erste Read() nicht aufgerufen oder "false" zurückgegeben).
Es wurde versucht, eine zuvor gelesene Spalte im sequenziellen Modus zu lesen.
Es wurde ein asynchroner Vorgang ausgeführt. Dies gilt für alle Get*-Methoden, wenn sie im sequenziellen Modus ausgeführt werden, da sie beim Lesen eines Datenstroms aufgerufen werden können.
Context Connection=true wird im Verbindungszeichenfolge angegeben.
Versuchen Sie, eine Spalte zu lesen, die nicht vorhanden ist.
Der Wert der Spalte war NULL (IsDBNull(Int32) == true), und ruft einen Nicht-SQL-Typ ab.
T stimmt nicht mit dem von SQL Server zurückgegebenen Typ überein oder kann nicht umgewandelt werden.
Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.
Hinweise
T kann eine der folgenden Typen sein:
Boolean, Byte, Char, DateTime, DateTimeOffset, Decimal, Double, Float, Guid, Int16, Int32, Int64, SqlBoolean, SqlByte, SqlDateTime, SqlDecimal, SqlDouble, SqlGuid, SqlInt16, SqlInt32, SqlInt64, SqlMoney, SqlSingle, SqlString, String oder UDT (beliebiger CLR-Typ mit markiert SqlUserDefinedTypeAttribute).
Weitere Informationen finden Sie unter SqlClient Streaming Support.