DbDataReader.GetFieldValueAsync Méthode

Définition

Obtient de manière asynchrone la valeur de la colonne spécifiée comme type demandé.Asynchronously gets the value of the specified column as the requested type.

Surcharges

GetFieldValueAsync<T>(Int32)

Obtient de manière asynchrone la valeur de la colonne spécifiée comme type demandé.Asynchronously gets the value of the specified column as the requested type.

GetFieldValueAsync<T>(Int32, CancellationToken)

Obtient de manière asynchrone la valeur de la colonne spécifiée comme type demandé.Asynchronously gets the value of the specified column as the requested type.

GetFieldValueAsync<T>(Int32)

Obtient de manière asynchrone la valeur de la colonne spécifiée comme type demandé.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)

Paramètres de type

T

Type de la valeur à retourner.The type of the value to be returned.

Paramètres

ordinal
Int32

Numéro de colonne de base zéro.The zero-based column ordinal.

Retours

Task<T>

Tâche dont Result contient la valeur de la colonne spécifiée.A task whose Result contains the value of the specified column.

Exceptions

La connexion a été supprimée ou fermée pendant la récupération des données.The connection was dropped or closed during data retrieval.

- ou --or-

Le lecteur de données a été fermé pendant la récupération des données.The data reader was closed during the data retrieval.

- ou --or-

Il n’existe aucune donnée prête à être lue (par exemple, le premier Read() n’a pas été appelé ou a retourné false).There is no data ready to be read (for example, the first Read() hasn't been called, or it returned false).

- ou --or-

Tentative de lecture d'une colonne précédemment lue en mode séquentiel.Tried to read a previously-read column in sequential mode.

- ou --or-

Il y avait une opération asynchrone en cours.There was an asynchronous operation in progress. Cela s’applique à toutes les méthodes Get_*_ exécutées en mode séquentiel, car elles peuvent être appelées pendant la lecture d’un flux.This applies to all Get_*_ methods when running in sequential mode, as they could be called while reading a stream.

L'index de colonne est hors limites.The column index is out of range.

La valeur retournée par la base de données ne correspond pas ou ne peut pas être castée en T.The value returned by the database doesn't match or cannot be cast to T.

Remarques

Cette méthode asynchrone n’est nécessaire que pour éviter de bloquer le thread appelant lorsque le lecteur est créé en mode séquentiel.This asynchronous method is only needed to avoid blocking the calling thread when the reader is created in sequential mode.

Si le mode séquentiel n’est pas spécifié, toutes les valeurs de colonne doivent être disponibles en mémoire à chaque fois que ReadAsync est terminé et que l’appel de la version synchrone de la méthode ne doit pas bloquer le thread appelant.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.

L’implémentation par défaut de cette méthode asynchrone appelle son équivalent synchrone et retourne une tâche terminée, bloquant potentiellement le thread appelant.The default implementation of this asynchronous method invokes its synchronous counterpart and returns a completed Task, potentially blocking the calling thread.

Les fournisseurs de données qui prennent en charge la programmation asynchrone doivent remplacer l’implémentation par défaut à l’aide d’opérations d’e/s asynchrones.Data providers that support asynchronous programming should override the default implementation using asynchronous I/O operations.

Les autres méthodes et propriétés de l'objet DbDataReader ne doivent pas être appelées tant que la tâche retournée n'est pas terminée.Other methods and properties of the DbDataReader object should not be invoked while the returned Task is not yet completed.

S’applique à

GetFieldValueAsync<T>(Int32, CancellationToken)

Obtient de manière asynchrone la valeur de la colonne spécifiée comme type demandé.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>
Public Overridable Function GetFieldValueAsync(Of T) (ordinal As Integer, cancellationToken As CancellationToken) As Task(Of T)

Paramètres de type

T

Type de la valeur à retourner.The type of the value to be returned.

Paramètres

ordinal
Int32

Numéro de colonne de base zéro.The zero-based column ordinal.

cancellationToken
CancellationToken

Jeton pour annuler l’opération asynchrone.A token to cancel the asynchronous operation.

Retours

Task<T>

Tâche dont Result contient la valeur de la colonne spécifiée.A task whose Result contains the value of the specified column.

Exceptions

La connexion a été supprimée ou fermée pendant la récupération des données.The connection was dropped or closed during data retrieval.

- ou --or-

Le lecteur de données a été fermé pendant la récupération des données.The data reader was closed during the data retrieval.

- ou --or-

Il n’existe aucune donnée prête à être lue (par exemple, le premier Read() n’a pas été appelé ou a retourné false).There is no data ready to be read (for example, the first Read() hasn't been called, or it returned false).

- ou --or-

Tentative de lecture d'une colonne précédemment lue en mode séquentiel.Tried to read a previously-read column in sequential mode.

- ou --or-

Il y avait une opération asynchrone en cours.There was an asynchronous operation in progress. Cela s’applique à toutes les méthodes Get_*_ exécutées en mode séquentiel, car elles peuvent être appelées pendant la lecture d’un flux.This applies to all Get_*_ methods when running in sequential mode, as they could be called while reading a stream.

L'index de colonne est hors limites.The column index is out of range.

La valeur retournée par la base de données ne correspond pas ou ne peut pas être castée en T.The value returned by the database doesn't match or cannot be cast to T.

Remarques

Cette méthode asynchrone n’est nécessaire que pour éviter de bloquer le thread appelant lorsque le lecteur est créé en mode séquentiel.This asynchronous method is only needed to avoid blocking the calling thread when the reader is created in sequential mode.

Si le mode séquentiel n’est pas spécifié, toutes les valeurs de colonne doivent être disponibles en mémoire à chaque fois que ReadAsync est terminé et que l’appel de la version synchrone de la méthode ne doit pas bloquer le thread appelant.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.

L’implémentation par défaut de cette méthode asynchrone appelle son équivalent synchrone et retourne une tâche terminée, bloquant potentiellement le thread appelant.The default implementation of this asynchronous method invokes its synchronous counterpart and returns a completed Task, potentially blocking the calling thread. L’implémentation par défaut retourne également une tâche annulée si un jeton d’annulation déjà annulé a été passé.The default implementation also returns a cancelled task if passed an already cancelled cancellation token.

Les fournisseurs de données qui prennent en charge la programmation asynchrone doivent remplacer l’implémentation par défaut à l’aide d’opérations d’e/s asynchrones.Data providers that support asynchronous programming should override the default implementation using asynchronous I/O operations.

Cette méthode accepte un jeton d'annulation qui peut être utilisé pour demander l'annulation de l'opération plus tôt que prévu.This method accepts a cancellation token that can be used to request the operation to be cancelled early. Les implémentations peuvent ignorer cette demande.Implementations may ignore this request.

Les autres méthodes et propriétés de l'objet DbDataReader ne doivent pas être appelées tant que la tâche retournée n'est pas terminée.Other methods and properties of the DbDataReader object should not be invoked while the returned Task is not yet completed.

S’applique à