OleDbDataReader Classe

Définition

Permet de lire un flux de données en avant uniquement à partir d’une source de données. Cette classe ne peut pas être héritée.

public ref class OleDbDataReader sealed : System::Data::Common::DbDataReader
public ref class OleDbDataReader sealed : MarshalByRefObject, IDisposable, System::Collections::IEnumerable, System::Data::IDataReader
public sealed class OleDbDataReader : System.Data.Common.DbDataReader
public sealed class OleDbDataReader : MarshalByRefObject, IDisposable, System.Collections.IEnumerable, System.Data.IDataReader
type OleDbDataReader = class
    inherit DbDataReader
type OleDbDataReader = class
    inherit MarshalByRefObject
    interface IDataReader
    interface IDisposable
    interface IDataRecord
    interface IEnumerable
Public NotInheritable Class OleDbDataReader
Inherits DbDataReader
Public NotInheritable Class OleDbDataReader
Inherits MarshalByRefObject
Implements IDataReader, IDisposable, IEnumerable
Héritage
Héritage
OleDbDataReader
Implémente

Exemples

L’exemple suivant crée un OleDbConnection, un OleDbCommandet un OleDbDataReader. L’exemple lit les données, en l’écrivant dans la console. Enfin, l’exemple ferme le OleDbDataReader, puis le OleDbConnection.

public static void ReadData(string connectionString, string queryString)
{
    using (OleDbConnection connection = new OleDbConnection(connectionString))
    {
        OleDbCommand command = new OleDbCommand(queryString, connection);

        connection.Open();
        OleDbDataReader reader = command.ExecuteReader();

        while (reader.Read())
        {
            Console.WriteLine(reader[0].ToString());
        }
        reader.Close();
    }
}
Public Sub ReadData(ByVal connectionString As String, _
    ByVal queryString As String)
    Using connection As New OleDbConnection(connectionString)
        Dim command As New OleDbCommand(queryString, connection)

        connection.Open()

        Dim reader As OleDbDataReader = command.ExecuteReader()
        While reader.Read()
            Console.WriteLine(reader(0).ToString())
        End While
        reader.Close()
    End Using
End Sub

Remarques

Pour créer un OleDbDataReader, vous devez appeler la méthode ExecuteReader de l’objet OleDbCommand, au lieu d’utiliser directement un constructeur.

Avant de fermer le OleDbConnection, fermez d’abord l’objet OleDbDataReader. Vous devez également fermer l’objet OleDbDataReader si vous envisagez de réutiliser un objet OleDbCommand. Par exemple, vous ne pouvez pas récupérer les paramètres de sortie tant que vous n’avez pas appelé Close.

Les modifications apportées à un jeu de résultats par un autre processus ou thread pendant la lecture des données peuvent être visibles par l’utilisateur de l'OleDbDataReader. Toutefois, le comportement précis dépend du minutage.

IsClosed et RecordsAffected sont les seules propriétés que vous pouvez appeler une fois le OleDbDataReader fermé. Bien que la propriété RecordsAffected soit accessible pendant que le OleDbDataReader existe, appelez toujours Close avant de retourner la valeur de RecordsAffected pour garantir une valeur de retour précise.

Propriétés

Depth

Obtient une valeur qui indique la profondeur d’imbrication de la ligne active.

FieldCount

Obtient le nombre de colonnes dans la ligne active.

HasRows

Obtient une valeur qui indique si le OleDbDataReader contient une ou plusieurs lignes.

IsClosed

Indique si le lecteur de données est fermé.

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 modifiées, insérées ou supprimées par l’exécution de l’instruction SQL.

VisibleFieldCount

Obtient le nombre de champs dans le OleDbDataReader qui ne sont pas masqués.

Méthodes

Close()

Ferme l’objet OleDbDataReader.

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 classe DbDataReader.

(Hérité de DbDataReader)
Dispose(Boolean)

Libère les ressources non managées utilisées par le 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)
Finalize()

Permet à l’objet d’essayer de libérer des ressources et d’effectuer d’autres opérations de nettoyage avant qu’il ne soit récupéré par garbage collection.

GetBoolean(Int32)

Obtient la valeur de la colonne spécifiée en tant que booléen.

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 du décalage de colonne spécifié dans la mémoire tampon en tant que tableau commençant par le décalage de mémoire tampon donné.

GetChar(Int32)

Obtient la valeur de la colonne spécifiée en tant que caractère.

GetChars(Int32, Int64, Char[], Int32, Int32)

Lit un flux de caractères du décalage de colonne spécifié dans la mémoire tampon en tant que tableau commençant par le décalage de mémoire tampon donné.

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.

(Hérité de DbDataReader)
GetData(Int32)

Retourne un objet OleDbDataReader pour l’ordinal de colonne demandée.

GetDataTypeName(Int32)

Obtient le nom du type de données source.

GetDateTime(Int32)

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.

(Hérité de DbDataReader)
GetDecimal(Int32)

Obtient la valeur de la colonne spécifiée en tant qu’objet Decimal.

GetDouble(Int32)

Obtient la valeur de la colonne spécifiée sous la forme d’un nombre à virgule flottante double précision.

GetEnumerator()

Retourne un IEnumerator qui peut être utilisé pour itérer dans les lignes du lecteur de données.

GetFieldType(Int32)

Obtient le Type qui est le 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()
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)

Obtient le nom de la colonne spécifiée.

GetOrdinal(String)

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.

(Hérité de DbDataReader)
GetProviderSpecificValue(Int32)

Obtient la valeur de la colonne spécifiée en tant qu’instance d’un type spécifique au fournisseur.

(Hérité de DbDataReader)
GetProviderSpecificValues(Object[])

Obtient toutes les colonnes d’attribut spécifiques au fournisseur dans la collection pour la ligne active.

(Hérité de DbDataReader)
GetSchemaTable()

Retourne un DataTable qui décrit les métadonnées de colonne du OleDbDataReader.

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.

(Hérité de DbDataReader)
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)
GetTimeSpan(Int32)

Obtient la valeur de la colonne spécifiée en tant qu’objet TimeSpan.

GetType()

Obtient la Type de l’instance actuelle.

(Hérité de Object)
GetValue(Int32)

Obtient la valeur de la colonne au format ordinal spécifié dans son format natif.

GetValues(Object[])

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)

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 MarshalByRefObject actuel.

(Hérité de MarshalByRefObject)
NextResult()

Avance le lecteur de données vers le résultat suivant, lors de la lecture des résultats des instructions SQL batch.

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 OleDbDataReader jusqu’au prochain enregistrement.

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

IDataRecord.GetData(Int32)

Retourne un IDataReader pour l’ordinal de colonne spécifié.

IDataRecord.GetData(Int32)

Pour obtenir une description de ce membre, consultez GetData(Int32).

(Hérité de DbDataReader)
IDisposable.Dispose()

Cette API prend en charge l'infrastructure du produit et n'est pas destinée à être utilisée directement à partir de votre code.

Libère les ressources utilisées par l’instance actuelle de la classe OleDbDataReader.

IEnumerable.GetEnumerator()

Retourne un énumérateur qui itère dans une collection.

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.

S’applique à

Voir aussi