SqlDataReader.GetFieldValue<T>(Int32) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient, de manière asynchrone, la valeur de la colonne spécifiée sous la forme d'un type. GetFieldValueAsync<T>(Int32, CancellationToken) est la version asynchrone de cette méthode.
public:
generic <typename T>
override T GetFieldValue(int i);
public override T GetFieldValue<T> (int i);
override this.GetFieldValue : int -> 'T
Public Overrides Function GetFieldValue(Of T) (i As Integer) As T
Paramètres de type
- T
Type de la valeur à retourner.
Paramètres
- i
- Int32
Colonne à récupérer.
Retours
Objet de type retourné.
Exceptions
La connexion est perdue ou est fermée pendant la récupération des données.
Fermeture de SqlDataReader au cours de la récupération des données.
Il n'existe aucune donnée prête à être lue (par exemple, le premier Read() n'a pas été appelé ou retourné comme false).
Tentative de lecture d'une colonne précédemment lue en mode séquentiel.
Il y avait une opération asynchrone en cours. 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 de données.
Tentative de lecture d'une colonne qui n'existe pas.
La valeur de la colonne était Null (IsDBNull(Int32) == true
), récupération d’un type autre que SQL.
T
ne correspond pas au type retourné par SQL Server ou ne peut pas être casté.
Remarques
T
peut être l’un des types suivants :
Booléen | Byte | Char | DateOnly (.NET 6 ou version ultérieure) |
DateTime | DateTimeOffset | Decimal | Double |
Float | Guid | Int16 | Int32 |
Int64 | SqlBoolean | SqlByte | SqlDateTime |
SqlDecimal | SqlDouble | SqlGuid | SqlInt16 |
SqlInt32 | SqlInt64 | SqlMoney | Sqlsingle |
SqlString | STREAM | String | TextReader |
TimeOnly (.NET 6 ou version ultérieure) | XmlReader | UDT, qui peut être n’importe quel type CLR marqué avec SqlUserDefinedTypeAttribute. |
Pour plus d’informations, consultez Prise en charge de SqlClient Streaming.