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

Definition

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

Überlädt

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

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

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

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

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

Ruft den Wert der angegebenen Spalte asynchron als angeforderten Typ ab.Asynchronously gets the value of the specified column as the requested 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

Die nullbasierte Ordnungszahl der Spalte.The zero-based column ordinal.

Gibt zurück

Task<T>

Eine Aufgabe, deren Result den Wert der angegebenen Spalte enthält.A task whose Result contains the value of the specified column.

Ausnahmen

Die Verbindung wurde während des Datenabrufs gelöscht oder geschlossen.The connection was dropped or closed during data retrieval.

- oder --or-

Der Datenreader wurde während des Datenabrufs geschlossen.The data reader was closed during the data retrieval.

- oder --or-

Es sind keine Daten zum Lesen vorhanden (beispielsweise wurde der erste Read() nicht aufgerufen oder hat false zurückgegeben).There is no data ready to be read (for example, the first Read() hasn't been called, or it 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 während des Lesens eines Datenstroms aufgerufen werden können.This applies to all Get*_ methods when running in sequential mode, as they could be called while reading a stream.

Der Spaltenindex ist außerhalb des gültigen Bereichs.The column index is out of range.

Der von der Datenbank zurückgegebene Wert passt nicht oder kann nicht in T umgewandelt werden.The value returned by the database doesn't match or cannot be cast to T.

Hinweise

Diese asynchrone Methode wird nur benötigt, um zu verhindern, dass der aufrufende Thread blockiert wird, wenn der Reader im sequenziellen Modus erstellt wird.This asynchronous method is only needed to avoid blocking the calling thread when the reader is created in sequential mode.

Wenn der sequenzielle Modus nicht angegeben wird, sollten alle Spaltenwerte im Arbeitsspeicher verfügbar werden, sobald "leseasync" abgeschlossen ist, und der Aufruf der synchronen Version der Methode sollte den aufrufenden Thread nicht blockieren.If sequential mode isn't specified, all column values should become available in memory each time ReadAsync completes, and calling the synchronous version of the method shouldn't block the calling thread.

Die Standard Implementierung dieser asynchronen Methode ruft die synchrone Entsprechung auf und gibt eine abgeschlossene Aufgabe zurück, die möglicherweise den aufrufenden Thread blockiert.The default implementation of this asynchronous method invokes its synchronous counterpart and returns a completed Task, potentially blocking the calling thread.

Datenanbieter, die die asynchrone Programmierung unterstützen, sollten die standardmäßige inmplementierung mithilfe von asynchronen e/a-Vorgängen überschreiben.Data providers that support asynchronous programming should override the default inmplementation using asynchronous I/O operations.

Andere Methoden und Eigenschaften des DbDataReader-Objekts sollten nicht aufgerufen werden, während die zurückgegebene Aufgabe noch nicht abgeschlossen ist.Other methods and properties of the DbDataReader object should not be invoked while the returned Task is not yet completed.

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

Ruft den Wert der angegebenen Spalte asynchron als angeforderten Typ ab.Asynchronously gets the value of the specified column as the requested 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

Die nullbasierte Ordnungszahl der Spalte.The zero-based column ordinal.

cancellationToken
CancellationToken CancellationToken CancellationToken CancellationToken

Ein Token zum Abbrechen des asynchronen Vorgangs.A token to cancel the asynchronous operation.

Gibt zurück

Task<T>

Eine Aufgabe, deren Result den Wert der angegebenen Spalte enthält.A task whose Result contains the value of the specified column.

Ausnahmen

Die Verbindung wurde während des Datenabrufs gelöscht oder geschlossen.The connection was dropped or closed during data retrieval.

- oder --or-

Der Datenreader wurde während des Datenabrufs geschlossen.The data reader was closed during the data retrieval.

- oder --or-

Es sind keine Daten zum Lesen vorhanden (beispielsweise wurde der erste Read() nicht aufgerufen oder hat false zurückgegeben).There is no data ready to be read (for example, the first Read() hasn't been called, or it 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 während des Lesens eines Datenstroms aufgerufen werden können.This applies to all Get*_ methods when running in sequential mode, as they could be called while reading a stream.

Der Spaltenindex ist außerhalb des gültigen Bereichs.The column index is out of range.

Der von der Datenbank zurückgegebene Wert passt nicht oder kann nicht in T umgewandelt werden.The value returned by the database doesn't match or cannot be cast to T.

Hinweise

Diese asynchrone Methode wird nur benötigt, um zu verhindern, dass der aufrufende Thread blockiert wird, wenn der Reader im sequenziellen Modus erstellt wird.This asynchronous method is only needed to avoid blocking the calling thread when the reader is created in sequential mode.

Wenn der sequenzielle Modus nicht angegeben wird, sollten alle Spaltenwerte im Arbeitsspeicher verfügbar werden, sobald "leseasync" abgeschlossen ist, und der Aufruf der synchronen Version der Methode sollte den aufrufenden Thread nicht blockieren.If sequential mode isn't specified, all column values should become available in memory each time ReadAsync completes, and calling the synchronous version of the method shouldn't block the calling thread.

Die Standard Implementierung dieser asynchronen Methode ruft die synchrone Entsprechung auf und gibt eine abgeschlossene Aufgabe zurück, die möglicherweise den aufrufenden Thread blockiert.The default implementation of this asynchronous method invokes its synchronous counterpart and returns a completed Task, potentially blocking the calling thread. Die Standard Implementierung gibt auch eine abgebrochene Aufgabe zurück, wenn ein bereits abgebrochenes Abbruch Token übergangen wird.The default implementation also returns a cancelled task if passed an already cancelled cancellation token.

Datenanbieter, die die asynchrone Programmierung unterstützen, sollten die standardmäßige inmplementierung mithilfe von asynchronen e/a-Vorgängen überschreiben.Data providers that support asynchronous programming should override the default inmplementation using asynchronous I/O operations.

Diese Methode nimmt ein Abbruchtoken an, das verwendet werden kann, um ein frühes Abbrechen des Vorgangs anzufordern.This method accepts a cancellation token that can be used to request the operation to be cancelled early. Implementierungen können diese Anforderung ignorieren.Implementations may ignore this request.

Andere Methoden und Eigenschaften des DbDataReader-Objekts sollten nicht aufgerufen werden, während die zurückgegebene Aufgabe noch nicht abgeschlossen ist.Other methods and properties of the DbDataReader object should not be invoked while the returned Task is not yet completed.

Gilt für: