DbDataReader Classe

Définition

Espace de noms:

System.Data.Common

Assembly:

System.Data.Common.dll

Source:

DbDataReader.cs

Lit un flux de lignes en avant uniquement à partir d’une source de données.

public ref class DbDataReader abstract : MarshalByRefObject, IAsyncDisposable, IDisposable, System::Collections::IEnumerable, System::Data::IDataReader

public abstract class DbDataReader : MarshalByRefObject, IAsyncDisposable, IDisposable, System.Collections.IEnumerable, System.Data.IDataReader

type DbDataReader = class
    inherit MarshalByRefObject
    interface IEnumerable
    interface IDataReader
    interface IDataRecord
    interface IDisposable
    interface IAsyncDisposable

Public MustInherit Class DbDataReader
Inherits MarshalByRefObject
Implements IAsyncDisposable, IDataReader, IDisposable, IEnumerable

Héritage

Object

MarshalByRefObject

DbDataReader

Dérivé

System.Data.DataTableReader

System.Data.EntityClient.EntityDataReader

System.Data.Odbc.OdbcDataReader

System.Data.OleDb.OleDbDataReader

System.Data.SqlClient.SqlDataReader

Implémente

IEnumerable IDisposable IDataReader IDataRecord IAsyncDisposable

Constructeurs

DbDataReader()

Initialise une nouvelle instance de la classe DbDataReader.

Propriétés

Depth	Obtient une valeur indiquant la profondeur d’imbrication de la ligne active.
FieldCount	En cas de substitution dans une classe dérivée, obtient le nombre de colonnes de la ligne active.
HasRows	En cas de substitution dans une classe dérivée, obtient une valeur qui indique si cette DbDataReader contient une ou plusieurs lignes.
IsClosed	En cas de substitution dans une classe dérivée, obtient une valeur indiquant si la DbDataReader est fermée.
Item[Int32]	En cas de substitution dans une classe dérivée, obtient la valeur de la colonne spécifiée en tant qu’instance de Object.
Item[String]	En cas de substitution dans une classe dérivée, obtient la valeur de la colonne spécifiée en tant qu’instance de Object.
RecordsAffected	En cas de substitution dans une classe dérivée, obtient le nombre de lignes modifiées, insérées ou supprimées par l’exécution de l’instruction SQL.
VisibleFieldCount	Obtient le nombre de champs dans le DbDataReader qui ne sont pas masqués.

Méthodes

Close()	Ferme l’objet DbDataReader.
CloseAsync()	Ferme de façon asynchrone l’objet 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 classe DbDataReader.
Dispose(Boolean)	Libère les ressources non managées utilisées par le DbDataReader et libère éventuellement les ressources managées.
DisposeAsync()	Libère de façon asynchrone toutes les ressources utilisées par l’instance actuelle de la classe DbDataReader.
Equals(Object)	Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object)
GetBoolean(Int32)	En cas de substitution dans une classe dérivée, obtient la valeur de la colonne spécifiée en tant que booléen.
GetByte(Int32)	En cas de substitution dans une classe dérivée, obtient la valeur de la colonne spécifiée sous forme d’octet.
GetBytes(Int32, Int64, Byte[], Int32, Int32)	En cas de substitution dans une classe dérivée, lit un nombre spécifié d’octets de la colonne spécifiée en commençant à 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(Int32)	En cas de substitution dans une classe dérivée, obtient la valeur de la colonne spécifiée en tant que caractère unique.
GetChars(Int32, Int64, Char[], Int32, Int32)	En cas de substitution dans une classe dérivée, lit un nombre spécifié de caractères d’une colonne spécifiée commençant à un index spécifié et les écrit dans une mémoire tampon commençant à une position spécifiée.
GetColumnSchemaAsync(CancellationToken)	Il s’agit de la version asynchrone de GetColumnSchema(DbDataReader). Les fournisseurs doivent remplacer par une implémentation appropriée. Le cancellationToken peut éventuellement être honoré. L’implémentation par défaut appelle l’appel de GetColumnSchema(DbDataReader) synchrone et retourne une tâche terminée. L’implémentation par défaut retourne une tâche annulée s’il a réussi un cancellationTokendéjà annulé. Les exceptions levées par GetColumnSchema(DbDataReader) sont communiquées via la propriété Exception de tâche retournée.
GetData(Int32)	Retourne un lecteur de données imbriqué pour la colonne demandée.
GetDataTypeName(Int32)	En cas de substitution dans une classe dérivée, obtient le nom du type de données de la colonne spécifiée.
GetDateTime(Int32)	En cas de substitution dans une classe dérivée, obtient la valeur de la colonne spécifiée en tant qu’objet DateTime.
GetDbDataReader(Int32)	Retourne un objet DbDataReader pour l’ordinal de colonne demandé qui peut être remplacé par une implémentation spécifique au fournisseur.
GetDecimal(Int32)	En cas de substitution dans une classe dérivée, obtient la valeur de la colonne spécifiée en tant que Decimal.
GetDouble(Int32)	En cas de substitution dans une classe dérivée, obtient la valeur de la colonne spécifiée en tant que nombre à virgule flottante double précision.
GetEnumerator()	En cas de substitution dans une classe dérivée, retourne un énumérateur qui peut être utilisé pour itérer dans les lignes du lecteur de données.
GetFieldType(Int32)	En cas de substitution dans une classe dérivée, obtient le type de données de la colonne spécifiée.
GetFieldValue<T>(Int32)	Obtient la valeur de la colonne spécifiée comme type demandé.
GetFieldValueAsync<T>(Int32, CancellationToken)	Obtient de façon asynchrone la valeur de la colonne spécifiée comme type demandé.
GetFieldValueAsync<T>(Int32)	Obtient de façon asynchrone la valeur de la colonne spécifiée comme type demandé.
GetFloat(Int32)	En cas de substitution dans une classe dérivée, obtient la valeur de la colonne spécifiée en tant que nombre à virgule flottante simple précision.
GetGuid(Int32)	En cas de substitution dans une classe dérivée, 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)	En cas de substitution dans une classe dérivée, obtient la valeur de la colonne spécifiée en tant qu’entier signé 16 bits.
GetInt32(Int32)	En cas de substitution dans une classe dérivée, obtient la valeur de la colonne spécifiée en tant qu’entier signé 32 bits.
GetInt64(Int32)	En cas de substitution dans une classe dérivée, obtient la valeur de la colonne spécifiée en tant qu’entier signé 64 bits.
GetLifetimeService()	Obsolète. 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)	En cas de substitution dans une classe dérivée, obtient le nom de la colonne, en fonction de l’ordinal de colonne de base zéro.
GetOrdinal(String)	En cas de substitution dans une classe dérivée, obtient l’ordinal de colonne en fonction du nom de la colonne.
GetProviderSpecificFieldType(Int32)	Obtient le type spécifique au fournisseur de la colonne spécifiée.
GetProviderSpecificValue(Int32)	Obtient la valeur de la colonne spécifiée en tant qu’instance d’un type spécifique au fournisseur.
GetProviderSpecificValues(Object[])	Obtient toutes les colonnes d’attribut spécifiques au fournisseur dans la collection pour la ligne active.
GetSchemaTable()	Retourne un DataTable qui décrit les métadonnées de colonne du DbDataReader. Retourne null si la commande exécutée n’a retourné aucun jeu de résultats, ou après NextResult() retourne false.
GetSchemaTableAsync(CancellationToken)	Il s’agit de la version asynchrone de GetSchemaTable(). Les fournisseurs doivent remplacer par une implémentation appropriée. Le cancellationToken peut éventuellement être honoré. L’implémentation par défaut appelle l’appel de GetSchemaTable() synchrone et retourne une tâche terminée. L’implémentation par défaut retourne une tâche annulée s’il a réussi un cancellationTokendéjà annulé. Les exceptions levées par GetSchemaTable() sont communiquées via la propriété Exception de tâche retournée.
GetStream(Int32)	Obtient un flux pour récupérer des données à partir de la colonne spécifiée.
GetString(Int32)	En cas de substitution dans une classe dérivée, obtient la valeur de la colonne spécifiée en tant qu’instance de String.
GetTextReader(Int32)	Obtient un lecteur de texte pour récupérer des données de la colonne.
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
GetValue(Int32)	En cas de substitution dans une classe dérivée, obtient la valeur de la colonne spécifiée en tant qu’instance de Object.
GetValues(Object[])	En cas de substitution dans une classe dérivée, remplit un tableau d’objets avec les valeurs de colonne de la ligne actuelle.
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)	En cas de substitution dans une classe dérivée, 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.
IsDBNullAsync(Int32)	Obtient de façon asynchrone une valeur qui indique si la colonne contient des valeurs inexistantes ou manquantes.
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
MemberwiseClone(Boolean)	Crée une copie superficielle de l’objet MarshalByRefObject actuel. (Hérité de MarshalByRefObject)
NextResult()	En cas de substitution dans une classe dérivée, avance le lecteur au résultat suivant lors de la lecture des résultats d’un lot d’instructions.
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.
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.
Read()	En cas de substitution dans une classe dérivée, avance le lecteur vers l’enregistrement suivant dans un jeu de résultats.
ReadAsync()	Avance de façon asynchrone le lecteur vers l’enregistrement suivant dans un jeu de résultats.
ReadAsync(CancellationToken)	Avance de façon asynchrone le lecteur vers l’enregistrement suivant dans un jeu de résultats.
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).

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 (collectionDbColumn) d’un DbDataReader.
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.
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.
Cast<TResult>(IEnumerable)	Convertit les éléments d’un IEnumerable en type spécifié.
OfType<TResult>(IEnumerable)	Filtre les éléments d’une IEnumerable en fonction d’un 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 jetable asynchrone sont effectuées.

Voir aussi

• DbProviderFactories (ADO.NET)
• ADO.NET Vue d’ensemble