DataTableReader Classe

Définition

Espace de noms:

System.Data

Assembly:

System.Data.Common.dll

Assembly:

System.Data.dll

Assembly:

netstandard.dll

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::DbDataReader

public sealed class DataTableReader : System.Data.Common.DbDataReader

type DataTableReader = class
    inherit DbDataReader

Public NotInheritable Class DataTableReader
Inherits DbDataReader

Héritage

Object

MarshalByRefObject

DbDataReader

DataTableReader

Remarques

Le DataTableReader fonctionnement ressemble beaucoup à n’importe quel autre lecteur de données, tel que le SqlDataReader, sauf que les DataTableReader fournit pour itérer sur des 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’original 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 DataTableCollection DataSet .

Le jeu de résultats retourné contient uniquement la version actuelle de chaque DataRowligne marquée pour suppression.

Fournit DataTableReader un itérateur stable; autrement dit, le contenu de la DataTableReader collection sous-jacente 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 Rows collection sont supprimées ou supprimées pendant l’itération, la position actuelle au sein de la DataTableReader collection est conservée de manière appropriée et n’invalide pas l’itérateur.

Constructeurs

DataTableReader(DataTable)	Initialise une nouvelle instance de la classe DataTableReader en utilisant des données provenant du DataTable spécifié.
DataTableReader(DataTable[])	Initialise une nouvelle instance de la classe DataTableReader avec le tableau d'objets DataTable fourni.

Propriétés

Depth	Profondeur d'imbrication de la ligne en cours du DataTableReader.
FieldCount	Retourne le nombre de colonnes figurant dans la ligne en cours.
HasRows	Obtient une valeur qui indique si DataTableReader contient une ou plusieurs lignes.
IsClosed	Obtient une valeur qui indique si le DataTableReader est fermé.
Item[Int32]	Obtient la valeur de la colonne spécifiée dans son format natif en fonction du numéro de la 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 DbDataReader qui ne sont pas masqués. (Hérité de DbDataReader)

Méthodes

Close()	Ferme le DataTableReader en cours.
CloseAsync()	Ferme de façon asynchrone l’objet DbDataReader. (Hérité de DbDataReader)
CreateObjRef(Type)	Crée un objet contenant toutes les informations appropriées requises pour générer un proxy permettant de communiquer avec un objet distant. (Hérité de MarshalByRefObject)
Dispose()	Libère toutes les ressources utilisées par l'instance actuelle de la classe DbDataReader. (Hérité de DbDataReader)
Dispose(Boolean)	Libère les ressources non managées utilisées par DbDataReader 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 classe DbDataReader. (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 sous la forme d'un Boolean.
GetByte(Int32)	Obtient la valeur de la colonne spécifiée sous la forme d'un octet.
GetBytes(Int32, Int64, Byte[], Int32, Int32)	Lit un flux d'octets à partir de l'offset de colonne spécifié dans la mémoire tampon, sous la forme d'un tableau en commençant à l'offset de mémoire tampon spécifié.
GetChar(Int32)	Obtient la valeur de la colonne spécifiée sous la forme d'un caractère.
GetChars(Int32, Int64, Char[], Int32, Int32)	Retourne la valeur de la colonne spécifiée sous la forme d'un tableau de caractères.
GetColumnSchemaAsync(CancellationToken)	Il s'agit de la version asynchrone de GetColumnSchema(DbDataReader). Les fournisseurs doivent effectuer le remplacement avec une implémentation appropriée. Le cancellationToken peut éventuellement être respecté. L'implémentation par défaut appelle l'appel de méthode GetColumnSchema(DbDataReader) synchrone et retourne une tâche terminée. L'implémentation par défaut retourne une tâche annulée si un cancellationToken déjà annulé est passé. Les exceptions levées par GetColumnSchema(DbDataReader) sont communiquées via la propriété d'exception de tâche retournée. (Hérité de DbDataReader)
GetData(Int32)	Retourne un lecteur de données imbriqué pour la colonne demandée. (Hérité de DbDataReader)
GetDataTypeName(Int32)	Obtient une chaîne qui représente le type de données de la colonne spécifiée.
GetDateTime(Int32)	Obtient la valeur de la colonne spécifiée sous la forme d'un objet DateTime.
GetDbDataReader(Int32)	Retourne un objet DbDataReader pour l'ordinal de colonne demandé qui peut être substitué par une implémentation spécifique au fournisseur. (Hérité de DbDataReader)
GetDecimal(Int32)	Obtient la valeur de la colonne spécifiée sous la forme d'un 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 au sein de la collection d'éléments.
GetFieldType(Int32)	Obtient le Type qui correspond au 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)	Obtient de manière asynchrone la valeur de la colonne spécifiée comme type demandé. (Hérité de DbDataReader)
GetFieldValueAsync<T>(Int32, CancellationToken)	Obtient de manière 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 sous la forme d'un identificateur global unique (GUID, Globally Unique IDentifier).
GetHashCode()	Fait office 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()	Obsolète. Récupère l'objet de service de durée de vie en cours 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 sous la forme d'un String.
GetOrdinal(String)	Obtient le numéro de la colonne, en fonction du nom de la colonne.
GetProviderSpecificFieldType(Int32)	Obtient le type de la colonne spécifiée dans le format spécifique au fournisseur.
GetProviderSpecificValue(Int32)	Obtient la valeur de la colonne spécifiée dans le format spécifique au fournisseur.
GetProviderSpecificValues(Object[])	Remplit le tableau fourni avec les informations de type spécifiques au fournisseur pour toutes les colonnes du DataTableReader.
GetSchemaTable()	Retourne un DataTable qui décrit les métadonnées de colonne de DataTableReader.
GetSchemaTableAsync(CancellationToken)	Il s'agit de la version asynchrone de GetSchemaTable(). Les fournisseurs doivent effectuer le remplacement avec une implémentation appropriée. Le cancellationToken peut éventuellement être respecté. L'implémentation par défaut appelle l'appel de méthode GetSchemaTable() synchrone et retourne une tâche terminée. L'implémentation par défaut retourne une tâche annulée si un cancellationToken déjà annulé est passé. Les exceptions levées par GetSchemaTable() sont communiquées via la propriété d'exception de tâche retournée. (Hérité de DbDataReader)
GetStream(Int32)	Obtient un flux pour récupérer les données de la colonne spécifiée. (Hérité de DbDataReader)
GetString(Int32)	Obtient la valeur de la colonne spécifiée sous la forme d'une chaîne.
GetTextReader(Int32)	Obtient un lecteur de texte pour récupérer les données de la colonne. (Hérité de DbDataReader)
GetType()	Obtient le 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 en cours.
InitializeLifetimeService()	Obsolète. 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)	Obtient de manière asynchrone une valeur qui indique si la colonne contient des valeurs inexistantes ou manquantes. (Hérité de DbDataReader)
IsDBNullAsync(Int32, CancellationToken)	Obtient de manière 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 Object actuel. (Hérité de Object)
MemberwiseClone(Boolean)	Crée une copie superficielle de l'objet MarshalByRefObject actuel. (Hérité de MarshalByRefObject)
NextResult()	Avance le DataTableReader jusqu'au jeu de résultats suivant, s'il existe.
NextResultAsync()	Avance le lecteur de manière asynchrone jusqu’au résultat suivant lors de la lecture des résultats d’un lot d’instructions. (Hérité de DbDataReader)
NextResultAsync(CancellationToken)	Avance le lecteur de manière asynchrone jusqu’au résultat suivant lors de la lecture des résultats d’un lot d’instructions. (Hérité de DbDataReader)
Read()	Fait passer le DataTableReader à l’enregistrement suivant.
ReadAsync()	Avance le lecteur de manière asynchrone jusqu’à l’enregistrement suivant d’un jeu de résultats. (Hérité de DbDataReader)
ReadAsync(CancellationToken)	Avance le lecteur de manière asynchrone jusqu’à l’enregistrement suivant d’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

IDataRecord.GetData(Int32)

Pour obtenir une description de ce membre, consultez GetData(Int32). (Hérité de DbDataReader)

Méthodes d’extension

CanGetColumnSchema(DbDataReader)	Obtient une valeur qui indique si un DbDataReader peut obtenir un schéma de colonne.
GetColumnSchema(DbDataReader)	Obtient le schéma de colonne (collection DbColumn) pour un DbDataReader.
GetBoolean(DbDataReader, String)	Obtient la valeur de la colonne spécifiée sous la forme d'une valeur Boolean.
GetByte(DbDataReader, String)	Obtient la valeur de la colonne spécifiée sous la forme d'un octet.
GetBytes(DbDataReader, String, Int64, Byte[], Int32, Int32)	Lit un nombre spécifié d’octets à partir de la colonne spécifiée, en commençant à un index spécifié et les écrit dans une mémoire tampon, à une position spécifiée de la mémoire tampon.
GetChar(DbDataReader, String)	Obtient la valeur de la colonne spécifiée sous forme de 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, en commençant à un index spécifié et les écrit dans une mémoire tampon, à une position spécifiée.
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 sous la forme d'un objet DateTime.
GetDecimal(DbDataReader, String)	Obtient la valeur de la colonne spécifiée sous la forme d'un Decimal.
GetDouble(DbDataReader, String)	Obtient la valeur de la colonne spécifiée sous forme de 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 manière 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 sous forme d’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 sous forme d’une instance d’un type spécifique au fournisseur.
GetStream(DbDataReader, String)	Obtient un flux pour récupérer les données de la colonne spécifiée.
GetString(DbDataReader, String)	Obtient la valeur de la colonne spécifiée sous la forme d'une instance de l'objet String.
GetTextReader(DbDataReader, String)	Obtient un lecteur de texte pour récupérer les données de la colonne.
GetValue(DbDataReader, String)	Obtient la valeur de la colonne spécifiée sous la forme d'une instance de l'objet Object.
IsDBNull(DbDataReader, String)	Obtient une valeur qui indique si la colonne contient des valeurs inexistantes ou manquantes.
IsDBNullAsync(DbDataReader, String, CancellationToken)	Obtient de manière asynchrone une valeur qui indique si la colonne contient des valeurs inexistantes ou manquantes.
Cast<TResult>(IEnumerable)	Effectue un cast des éléments d'un IEnumerable vers le type spécifié.
OfType<TResult>(IEnumerable)	Filtre les éléments d'un IEnumerable en fonction du type spécifié.
AsParallel(IEnumerable)	Active la parallélisation d'une requête.
AsQueryable(IEnumerable)	Convertit un IEnumerable en IQueryable.
ConfigureAwait(IAsyncDisposable, Boolean)	Configure la façon dont les attentes sur les tâches retournées à partir d’un élément supprimable asynchrone sont effectuées.