DbDataReader.GetFieldValueAsync DbDataReader.GetFieldValueAsync DbDataReader.GetFieldValueAsync DbDataReader.GetFieldValueAsync Method

Definition

Ruft den Wert der angegebenen Spalte asynchron als ein Typ ab.Asynchronously gets the value of the specified column as a type.

Überlädt

GetFieldValueAsync<T>(Int32) GetFieldValueAsync<T>(Int32) GetFieldValueAsync<T>(Int32) GetFieldValueAsync<T>(Int32)

Ruft den Wert der angegebenen Spalte asynchron als ein Typ ab.Asynchronously gets the value of the specified column as a type.

GetFieldValueAsync<T>(Int32, CancellationToken) GetFieldValueAsync<T>(Int32, CancellationToken) GetFieldValueAsync<T>(Int32, CancellationToken)

Ruft den Wert der angegebenen Spalte asynchron als ein Typ ab.Asynchronously gets the value of the specified column as a type.

Hinweise

Weitere Informationen finden Sie unter SqlClient-Streamingunterstützung.For more information, see SqlClient Streaming Support.

GetFieldValueAsync<T>(Int32) GetFieldValueAsync<T>(Int32) GetFieldValueAsync<T>(Int32) GetFieldValueAsync<T>(Int32)

Ruft den Wert der angegebenen Spalte asynchron als ein Typ ab.Asynchronously gets the value of the specified column as a type.

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)

Typparameter

T

Der Typ des zurückzugebenden Werts.The type of the value to be returned.

Parameter

ordinal
Int32 Int32 Int32 Int32

Der Typ des zurückzugebenden Werts.The type of the value to be returned.

Gibt zurück

Task<T>

Der Typ des zurückzugebenden Werts.The type of the value to be returned.

Ausnahmen

Die Verbindung wird während des Datenabrufs getrennt oder geschlossen.The connection drops or is closed during the data retrieval.

- oder --or-

Der DbDataReader wird während des Datenabrufs geschlossen.The DbDataReader is closed during the data retrieval.

- oder --or-

Es gibt keine Daten, die gelesen werden können (der erste Aufruf von Read() hat z. B. nicht stattgefunden oder "false" zurückgegeben).There is no data ready to be read (for example, the first Read() hasn't been called, or returned false).

- oder --or-

Es wurde versucht, eine zuvor gelesene Spalte im sequenziellen Modus zu lesen.Tried to read a previously-read column in sequential mode.

- oder --or-

Es gab einen aktiven asynchronen Vorgang.There was an asynchronous operation in progress. Dies gilt für alle Get*-Methoden bei der Ausführung im sequenziellen Modus, da sie aufgerufen werden können, während des Lesens eines Datenstroms.This applies to all Get* methods when running in sequential mode, as they could be called while reading a stream.

Es wurde versucht, eine Spalte zu lesen, die nicht vorhanden ist.Trying to read a column that does not exist.

T entspricht nicht dem Typ, der von der Datenquelle zurückgegeben wird, oder kann nicht umgewandelt werden.T doesn't match the type returned by the data source or cannot be cast.

Hinweise

T Dabei kann es sich um eine der folgenden Typen sein:T can be one of the following types:

BooleschBoolean ByteByte CharChar DateTimeDateTime
DateTimeOffsetDateTimeOffset DecimalDecimal DoubleDouble FloatFloat
GUIDGuid Int16Int16 Int32Int32 Int64Int64
ZeichenfolgeString

Weitere Informationen finden Sie unter SqlClient-Streamingunterstützung.For more information, see SqlClient Streaming Support.

GetFieldValueAsync<T>(Int32, CancellationToken) GetFieldValueAsync<T>(Int32, CancellationToken) GetFieldValueAsync<T>(Int32, CancellationToken)

Ruft den Wert der angegebenen Spalte asynchron als ein Typ ab.Asynchronously gets the value of the specified column as a type.

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>

Typparameter

T

Der Typ des zurückzugebenden Werts.The type of the value to be returned.

Parameter

ordinal
Int32 Int32 Int32 Int32

Der Typ des zurückzugebenden Werts.The type of the value to be returned.

cancellationToken
CancellationToken CancellationToken CancellationToken CancellationToken

Die Abbruch-Anweisung, die eine Benachrichtigung verteilt, dass Vorgänge abgebrochen werden sollen.The cancellation instruction, which propagates a notification that operations should be canceled. Dies garantiert keinen Abbruch.This does not guarantee the cancellation. Die Einstellung CancellationToken.None macht diese Methode äquivalent zu GetFieldValueAsync<T>(Int32).A setting of CancellationToken.None makes this method equivalent to GetFieldValueAsync<T>(Int32). Die zurückgegebene Aufgabe muss als abgebrochen gekennzeichnet werden.The returned task must be marked as cancelled.

Gibt zurück

Task<T>

Der Typ des zurückzugebenden Werts.The type of the value to be returned.

Ausnahmen

Die Verbindung wird während des Datenabrufs getrennt oder geschlossen.The connection drops or is closed during the data retrieval.

- oder --or-

Der DbDataReader wird während des Datenabrufs geschlossen.The DbDataReader is closed during the data retrieval.

- oder --or-

Es gibt keine Daten, die gelesen werden können (der erste Aufruf von Read() hat z. B. nicht stattgefunden oder "false" zurückgegeben).There is no data ready to be read (for example, the first Read() hasn't been called, or returned false).

- oder --or-

Es wurde versucht, eine zuvor gelesene Spalte im sequenziellen Modus zu lesen.Tried to read a previously-read column in sequential mode.

- oder --or-

Es gab einen aktiven asynchronen Vorgang.There was an asynchronous operation in progress. Dies gilt für alle Get*-Methoden bei der Ausführung im sequenziellen Modus, da sie aufgerufen werden können, während des Lesens eines Datenstroms.This applies to all Get* methods when running in sequential mode, as they could be called while reading a stream.

Es wurde versucht, eine Spalte zu lesen, die nicht vorhanden ist.Trying to read a column that does not exist.

T entspricht nicht dem Typ, der von der Datenquelle zurückgegeben wird, oder kann nicht umgewandelt werden.T doesn't match the type returned by the data source or cannot be cast.

Hinweise

T Dabei kann es sich um eine der folgenden Typen sein:T can be one of the following types:

BooleschBoolean ByteByte CharChar DateTimeDateTime
DateTimeOffsetDateTimeOffset DecimalDecimal DoubleDouble FloatFloat
GUIDGuid Int16Int16 Int32Int32 Int64Int64
ZeichenfolgeString

Weitere Informationen finden Sie unter SqlClient-Streamingunterstützung.For more information, see SqlClient Streaming Support.

Gilt für: