DataTableReader Classe
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.
L'objet DataTableReader obtient le contenu d'un ou plusieurs objets DataTable sous la forme d'un ou plusieurs jeux de résultats en lecture seule et en avant uniquement.
public ref class DataTableReader sealed : System::Data::Common::DbDataReaderpublic sealed class DataTableReader : System.Data.Common.DbDataReadertype DataTableReader = class
inherit DbDataReaderPublic NotInheritable Class DataTableReader
Inherits DbDataReader- Héritage
Remarques
Le DataTableReader travail fonctionne beaucoup comme n’importe quel autre lecteur de données, tel que le SqlDataReader, sauf que les DataTableReader fournit pour itérer sur les lignes dans un DataTable. En d’autres termes, il fournit une itération sur des lignes dans un cache. Les données mises en cache peuvent être modifiées pendant l’activité DataTableReader et le lecteur conserve automatiquement sa position.
Lorsque vous créez un DataTableReader objet à partir d’un DataTable, l’objet résultant DataTableReader contient un jeu de résultats avec les mêmes données que celles DataTable à partir de laquelle il a été créé, à l’exception des lignes marquées comme supprimées. Les colonnes apparaissent dans le même ordre que dans l’original DataTable. La structure du résultat retourné est identique dans le schéma et les données à l’origine DataTable. Un DataTableReader qui a été créé en appelant la CreateDataReader méthode d’un DataSet objet contient plusieurs jeux de résultats si celui-ci DataSet contient plusieurs tables. Les résultats se trouvent dans la même séquence que les DataTable objets de l’objet DataTableCollectionDataSet .
Le jeu de résultats retourné contient uniquement la version actuelle de chaque DataRowligne ; les lignes marquées pour suppression sont ignorées.
Il DataTableReader fournit un itérateur stable ; autrement dit, le contenu du DataTableReader fichier n’est pas invalidé si la taille de la collection sous-jacente est modifiée pendant l’itération. Par exemple, si une ou plusieurs lignes de la collection sont supprimées ou supprimées pendant l’itération Rows , la position actuelle dans le DataTableReader fichier est conservée de manière appropriée et elle n’invalide pas l’itérateur.
Constructeurs
| Nom | Description |
|---|---|
| DataTableReader(DataTable) |
Initialise une nouvelle instance de la DataTableReader classe à l’aide de données de l’instance fournie DataTable. |
| DataTableReader(DataTable[]) |
Initialise une nouvelle instance de la classe à l’aide DataTableReader du tableau d’objets DataTable fourni. |
Propriétés
| Nom | Description |
|---|---|
| Depth |
Profondeur de l’imbrication de la ligne actuelle du DataTableReader. |
| FieldCount |
Retourne le nombre de colonnes dans la ligne active. |
| HasRows |
Obtient une valeur qui indique si les DataTableReader lignes contiennent une ou plusieurs lignes. |
| IsClosed |
Obtient une valeur qui indique si la DataTableReader valeur est fermée. |
| Item[Int32] |
Obtient la valeur de la colonne spécifiée dans son format natif en fonction de l’ordinal de colonne. |
| Item[String] |
Obtient la valeur de la colonne spécifiée dans son format natif en fonction du nom de la colonne. |
| RecordsAffected |
Obtient le nombre de lignes insérées, modifiées ou supprimées par l’exécution de l’instruction SQL. |
| VisibleFieldCount |
Obtient le nombre de champs dans les DbDataReader champs qui ne sont pas masqués. (Hérité de DbDataReader) |
Méthodes
| Nom | Description |
|---|---|
| Close() |
Ferme le fichier actif DataTableReader. |
| CloseAsync() |
Ferme de façon asynchrone l’objet DbDataReader . (Hérité de DbDataReader) |
| CreateObjRef(Type) |
Crée un objet qui contient toutes les informations pertinentes requises pour générer un proxy utilisé pour communiquer avec un objet distant. (Hérité de MarshalByRefObject) |
| Dispose() |
Libère toutes les ressources utilisées par l’instance actuelle de la DbDataReader classe. (Hérité de DbDataReader) |
| Dispose(Boolean) |
Libère les ressources non managées utilisées par les DbDataReader ressources gérées et libère éventuellement les ressources managées. (Hérité de DbDataReader) |
| DisposeAsync() |
Libère de façon asynchrone toutes les ressources utilisées par l’instance actuelle de la DbDataReader classe. (Hérité de DbDataReader) |
| Equals(Object) |
Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object) |
| GetBoolean(Int32) |
Obtient la valeur de la colonne spécifiée en tant que Boolean. |
| GetByte(Int32) |
Obtient la valeur de la colonne spécifiée sous forme d’octet. |
| GetBytes(Int32, Int64, Byte[], Int32, Int32) |
Lit un flux d’octets commençant à l’offset de colonne spécifié dans la mémoire tampon en tant que tableau commençant par le décalage de mémoire tampon spécifié. |
| GetChar(Int32) |
Obtient la valeur de la colonne spécifiée en tant que caractère. |
| GetChars(Int32, Int64, Char[], Int32, Int32) |
Retourne la valeur de la colonne spécifiée en tant que tableau de caractères. |
| GetData(Int32) |
Retourne un lecteur de données imbriqué pour la colonne demandée. (Hérité de DbDataReader) |
| GetDataTypeName(Int32) |
Obtient une chaîne représentant le type de données de la colonne spécifiée. |
| GetDateTime(Int32) |
Obtient la valeur de la colonne spécifiée en tant qu’objet DateTime . |
| GetDbDataReader(Int32) |
Retourne un DbDataReader objet pour l’ordinal de colonne demandée qui peut être remplacé par une implémentation spécifique au fournisseur. (Hérité de DbDataReader) |
| GetDecimal(Int32) |
Obtient la valeur de la colonne spécifiée en tant que Decimal. |
| GetDouble(Int32) |
Obtient la valeur de la colonne sous la forme d’un nombre à virgule flottante double précision. |
| GetEnumerator() |
Retourne un énumérateur qui peut être utilisé pour itérer dans la collection d’éléments. |
| GetFieldType(Int32) |
Obtient le Type type de données de l’objet. |
| GetFieldValue<T>(Int32) |
Obtient la valeur de la colonne spécifiée comme type demandé. (Hérité de DbDataReader) |
| GetFieldValueAsync<T>(Int32, CancellationToken) |
Obtient de façon asynchrone la valeur de la colonne spécifiée comme type demandé. (Hérité de DbDataReader) |
| GetFieldValueAsync<T>(Int32) |
Obtient de façon asynchrone la valeur de la colonne spécifiée comme type demandé. (Hérité de DbDataReader) |
| GetFloat(Int32) |
Obtient la valeur de la colonne spécifiée sous la forme d’un nombre à virgule flottante simple précision. |
| GetGuid(Int32) |
Obtient la valeur de la colonne spécifiée en tant qu’identificateur global unique (GUID). |
| GetHashCode() |
Sert de fonction de hachage par défaut. (Hérité de Object) |
| GetInt16(Int32) |
Obtient la valeur de la colonne spécifiée sous la forme d’un entier signé 16 bits. |
| GetInt32(Int32) |
Obtient la valeur de la colonne spécifiée sous la forme d’un entier signé 32 bits. |
| GetInt64(Int32) |
Obtient la valeur de la colonne spécifiée sous la forme d’un entier signé 64 bits. |
| GetLifetimeService() |
Récupère l’objet de service de durée de vie actuel qui contrôle la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject) |
| GetName(Int32) |
Obtient la valeur de la colonne spécifiée en tant que String. |
| GetOrdinal(String) |
Obtient l’ordinal de colonne, en fonction du nom de la colonne. |
| GetProviderSpecificFieldType(Int32) |
Obtient le type de la colonne spécifiée au format spécifique au fournisseur. |
| GetProviderSpecificValue(Int32) |
Obtient la valeur de la colonne spécifiée au format spécifique au fournisseur. |
| GetProviderSpecificValues(Object[]) |
Remplit le tableau fourni avec des informations de type spécifiques au fournisseur pour toutes les colonnes du DataTableReader. |
| GetSchemaTable() |
Retourne une DataTable valeur qui décrit les métadonnées de colonne du DataTableReader. |
| GetStream(Int32) |
Obtient un flux pour récupérer des données à partir de la colonne spécifiée. (Hérité de DbDataReader) |
| GetString(Int32) |
Obtient la valeur de la colonne spécifiée sous forme de chaîne. |
| GetTextReader(Int32) |
Obtient un lecteur de texte pour récupérer des données de la colonne. (Hérité de DbDataReader) |
| GetType() |
Obtient la Type de l’instance actuelle. (Hérité de Object) |
| GetValue(Int32) |
Obtient la valeur de la colonne spécifiée dans son format natif. |
| GetValues(Object[]) |
Remplit un tableau d’objets avec les valeurs de colonne de la ligne actuelle. |
| InitializeLifetimeService() |
Obtient un objet de service de durée de vie pour contrôler la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject) |
| IsDBNull(Int32) |
Obtient une valeur qui indique si la colonne contient des valeurs inexistantes ou manquantes. |
| IsDBNullAsync(Int32, CancellationToken) |
Obtient de façon asynchrone une valeur qui indique si la colonne contient des valeurs inexistantes ou manquantes. (Hérité de DbDataReader) |
| IsDBNullAsync(Int32) |
Obtient de façon asynchrone une valeur qui indique si la colonne contient des valeurs inexistantes ou manquantes. (Hérité de DbDataReader) |
| MemberwiseClone() |
Crée une copie superficielle du Objectactuel. (Hérité de Object) |
| MemberwiseClone(Boolean) |
Crée une copie superficielle de l’objet actuel MarshalByRefObject . (Hérité de MarshalByRefObject) |
| NextResult() |
Avance le DataTableReader jeu de résultats suivant, le cas échéant. |
| NextResultAsync() |
Avance de façon asynchrone le lecteur vers le résultat suivant lors de la lecture des résultats d’un lot d’instructions. (Hérité de DbDataReader) |
| NextResultAsync(CancellationToken) |
Avance de façon asynchrone le lecteur vers le résultat suivant lors de la lecture des résultats d’un lot d’instructions. (Hérité de DbDataReader) |
| Read() |
Avance le DataTableReader dossier suivant. |
| ReadAsync() |
Avance de façon asynchrone le lecteur vers l’enregistrement suivant dans un jeu de résultats. (Hérité de DbDataReader) |
| ReadAsync(CancellationToken) |
Avance de façon asynchrone le lecteur vers l’enregistrement suivant dans un jeu de résultats. (Hérité de DbDataReader) |
| ToString() |
Retourne une chaîne qui représente l’objet actuel. (Hérité de Object) |
Implémentations d’interfaces explicites
| Nom | Description |
|---|---|
| IDataRecord.GetData(Int32) |
Pour obtenir une description de ce membre, consultez GetData(Int32). (Hérité de DbDataReader) |
Méthodes d’extension
| Nom | Description |
|---|---|
| AsParallel(IEnumerable) |
Active la parallélisation d’une requête. |
| AsQueryable(IEnumerable) |
Convertit un IEnumerable en IQueryable. |
| CanGetColumnSchema(DbDataReader) |
Obtient une valeur qui indique si un DbDataReader schéma de colonne peut être obtenu. |
| Cast<TResult>(IEnumerable) |
Convertit les éléments d’un IEnumerable en type spécifié. |
| ConfigureAwait(IAsyncDisposable, Boolean) |
Configure la façon dont les attentes sur les tâches retournées à partir d’un jetable asynchrone sont effectuées. |
| GetBoolean(DbDataReader, String) |
Obtient la valeur de la colonne spécifiée en tant que booléen. |
| GetByte(DbDataReader, String) |
Obtient la valeur de la colonne spécifiée sous forme d’octet. |
| GetBytes(DbDataReader, String, Int64, Byte[], Int32, Int32) |
Lit un nombre spécifié d’octets de la colonne spécifiée à partir d’un index spécifié et les écrit dans une mémoire tampon commençant à une position spécifiée dans la mémoire tampon. |
| GetChar(DbDataReader, String) |
Obtient la valeur de la colonne spécifiée sous la forme d’un caractère unique. |
| GetChars(DbDataReader, String, Int64, Char[], Int32, Int32) |
Lit un nombre spécifié de caractères à partir d’une colonne spécifiée à partir d’un index spécifié et les écrit dans une mémoire tampon commençant à une position spécifiée. |
| GetColumnSchema(DbDataReader) |
Obtient le schéma de colonne (DbColumn collection) d’un DbDataReader. |
| GetData(DbDataReader, String) |
Retourne un lecteur de données imbriqué pour la colonne demandée. |
| GetDataTypeName(DbDataReader, String) |
Obtient le nom du type de données de la colonne spécifiée. |
| GetDateTime(DbDataReader, String) |
Obtient la valeur de la colonne spécifiée en tant qu’objet DateTime . |
| GetDecimal(DbDataReader, String) |
Obtient la valeur de la colonne spécifiée en tant que Decimal. |
| GetDouble(DbDataReader, String) |
Obtient la valeur de la colonne spécifiée sous la forme d’un nombre à virgule flottante double précision. |
| GetFieldType(DbDataReader, String) |
Obtient le type de données de la colonne spécifiée. |
| GetFieldValue<T>(DbDataReader, String) |
Obtient la valeur de la colonne spécifiée comme type demandé. |
| GetFieldValueAsync<T>(DbDataReader, String, CancellationToken) |
Obtient de façon asynchrone la valeur de la colonne spécifiée comme type demandé. |
| GetFloat(DbDataReader, String) |
Obtient la valeur de la colonne spécifiée sous la forme d’un nombre à virgule flottante simple précision. |
| GetGuid(DbDataReader, String) |
Obtient la valeur de la colonne spécifiée en tant qu’identificateur global unique (GUID). |
| GetInt16(DbDataReader, String) |
Obtient la valeur de la colonne spécifiée sous la forme d’un entier signé 16 bits. |
| GetInt32(DbDataReader, String) |
Obtient la valeur de la colonne spécifiée sous la forme d’un entier signé 32 bits. |
| GetInt64(DbDataReader, String) |
Obtient la valeur de la colonne spécifiée sous la forme d’un entier signé 64 bits. |
| GetProviderSpecificFieldType(DbDataReader, String) |
Obtient le type spécifique au fournisseur de la colonne spécifiée. |
| GetProviderSpecificValue(DbDataReader, String) |
Obtient la valeur de la colonne spécifiée en tant qu’instance d’un type spécifique au fournisseur. |
| GetStream(DbDataReader, String) |
Obtient un flux pour récupérer des données à partir de la colonne spécifiée. |
| GetString(DbDataReader, String) |
Obtient la valeur de la colonne spécifiée en tant qu’instance de String. |
| GetTextReader(DbDataReader, String) |
Obtient un lecteur de texte pour récupérer des données de la colonne. |
| GetValue(DbDataReader, String) |
Obtient la valeur de la colonne spécifiée en tant qu’instance de Object. |
| IsDBNull(DbDataReader, String) |
Obtient une valeur qui indique si la colonne contient des valeurs inexistantes ou manquantes. |
| IsDBNullAsync(DbDataReader, String, CancellationToken) |
Obtient de façon asynchrone une valeur qui indique si la colonne contient des valeurs inexistantes ou manquantes. |
| OfType<TResult>(IEnumerable) |
Filtre les éléments d’une IEnumerable en fonction d’un type spécifié. |