OleDbDataReader OleDbDataReader OleDbDataReader OleDbDataReader Class

Définition

Fournit un moyen de lire un flux de lignes de données avant uniquement à partir d'une source de données.Provides a way of reading a forward-only stream of data rows from a data source. Cette classe ne peut pas être héritée.This class cannot be inherited.

public ref class OleDbDataReader sealed : System::Data::Common::DbDataReader
public sealed class OleDbDataReader : System.Data.Common.DbDataReader
type OleDbDataReader = class
    inherit DbDataReader
Public NotInheritable Class OleDbDataReader
Inherits DbDataReader
Héritage

Exemples

L’exemple suivant crée un OleDbConnection, un OleDbCommandet un OleDbDataReader.The following example creates an OleDbConnection, an OleDbCommand, and an OleDbDataReader. L’exemple lit les données, en les écrivant dans la console.The example reads through the data, writing it out to the console. Enfin, l’exemple ferme le OleDbDataReader , puis le OleDbConnection.Finally, the example closes the OleDbDataReader and then the 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 ExecuteReader méthode de l' OleDbCommand objet au lieu d’utiliser directement un constructeur.To create an OleDbDataReader, you must call the ExecuteReader method of the OleDbCommand object, instead of directly using a constructor.

Avant de fermer le OleDbConnection, fermez d’abord OleDbDataReader l’objet.Before you close the OleDbConnection, first close the OleDbDataReader object. Vous devez également fermer l' OleDbDataReader objet si vous envisagez de resuser un OleDbCommand objet. Par exemple, vous ne pouvez pas récupérer les paramètres de sortie Closetant que vous n’avez pas appelé.You must also close the OleDbDataReader object if you plan to resuse an OleDbCommand object.For example, you cannot retrieve output parameters until after you call 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 OleDbDataReaderpar l’utilisateur du.Changes made to a result set by another process or thread while data is being read may be visible to the user of the OleDbDataReader. Toutefois, le comportement précis est dépendant du minutage.However, the precise behavior is timing dependent.

IsClosedet RecordsAffected sont les seules propriétés que vous pouvez appeler après la OleDbDataReader fermeture de.IsClosed and RecordsAffected are the only properties that you can call after the OleDbDataReader is closed. Bien que RecordsAffected la propriété soit accessible pendant l' OleDbDataReader existence de, appelez Close toujours avant de retourner la RecordsAffected valeur de pour garantir une valeur de retour précise.Although the RecordsAffected property may be accessed while the OleDbDataReader exists, always call Close before returning the value of RecordsAffected to guarantee an accurate return value.

Propriétés

Depth Depth Depth Depth

Obtient une valeur qui indique la profondeur d'imbrication de la ligne actuelle.Gets a value that indicates the depth of nesting for the current row.

FieldCount FieldCount FieldCount FieldCount

Obtient le nombre de colonnes figurant dans la ligne actuelle.Gets the number of columns in the current row.

HasRows HasRows HasRows HasRows

Obtient une valeur qui indique si OleDbDataReader contient une ou plusieurs lignes.Gets a value that indicates whether the OleDbDataReader contains one or more rows.

IsClosed IsClosed IsClosed IsClosed

Indique si le lecteur de données est fermé.Indicates whether the data reader is closed.

Item[Int32] Item[Int32] Item[Int32] Item[Int32]

Obtient la valeur de la colonne spécifiée dans son format natif en fonction du numéro de la colonne.Gets the value of the specified column in its native format given the column ordinal.

Item[String] Item[String] Item[String] Item[String]

Obtient la valeur de la colonne spécifiée dans son format natif en fonction du nom de la colonne.Gets the value of the specified column in its native format given the column name.

RecordsAffected RecordsAffected RecordsAffected RecordsAffected

Obtient le nombre de lignes modifiées, insérées ou supprimées par l'exécution de l'instruction SQL.Gets the number of rows changed, inserted, or deleted by execution of the SQL statement.

VisibleFieldCount VisibleFieldCount VisibleFieldCount VisibleFieldCount

Obtient le nombre de champs dans OleDbDataReader qui ne sont pas masqués.Gets the number of fields in the OleDbDataReader that are not hidden.

Méthodes

Close() Close() Close() Close()

Ferme l'objet OleDbDataReader.Closes the OleDbDataReader object.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) 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.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.Determines whether the specified object is equal to the current object.

(Inherited from Object)
Finalize() Finalize() Finalize() Finalize()

Autorise l'objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection.Allows the object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.

GetBoolean(Int32) GetBoolean(Int32) GetBoolean(Int32) GetBoolean(Int32)

Obtient la valeur de la colonne spécifiée sous la forme d'une valeur Boolean.Gets the value of the specified column as a Boolean.

GetByte(Int32) GetByte(Int32) GetByte(Int32) GetByte(Int32)

Obtient la valeur de la colonne spécifiée sous la forme d'un octet.Gets the value of the specified column as a byte.

GetBytes(Int32, Int64, Byte[], Int32, Int32) GetBytes(Int32, Int64, Byte[], Int32, Int32) GetBytes(Int32, Int64, Byte[], Int32, Int32) 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 commençant à l'offset de mémoire tampon donné.Reads a stream of bytes from the specified column offset into the buffer as an array starting at the given buffer offset.

GetChar(Int32) GetChar(Int32) GetChar(Int32) GetChar(Int32)

Obtient la valeur de la colonne spécifiée sous la forme d'un caractère.Gets the value of the specified column as a character.

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

Lit un flux de caractères à 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 donné.Reads a stream of characters from the specified column offset into the buffer as an array starting at the given buffer offset.

GetData(Int32) GetData(Int32) GetData(Int32) GetData(Int32)

Retourne un objet OleDbDataReader pour le numéro de colonne demandé.Returns an OleDbDataReader object for the requested column ordinal.

GetDataTypeName(Int32) GetDataTypeName(Int32) GetDataTypeName(Int32) GetDataTypeName(Int32)

Obtient le nom du type de données source.Gets the name of the source data type.

GetDateTime(Int32) GetDateTime(Int32) GetDateTime(Int32) GetDateTime(Int32)

Obtient la valeur de la colonne spécifiée sous la forme d'un objet DateTime.Gets the value of the specified column as a DateTime object.

GetDecimal(Int32) GetDecimal(Int32) GetDecimal(Int32) GetDecimal(Int32)

Obtient la valeur de la colonne spécifiée sous la forme d'un objet Decimal.Gets the value of the specified column as a Decimal object.

GetDouble(Int32) GetDouble(Int32) GetDouble(Int32) GetDouble(Int32)

Obtient la valeur de la colonne spécifiée sous la forme d'un nombre à virgule flottante double précision.Gets the value of the specified column as a double-precision floating-point number.

GetEnumerator() GetEnumerator() GetEnumerator() GetEnumerator()

Retourne un objet IEnumerator qui peut être utilisé pour itérer au sein des lignes dans le lecteur de données.Returns an IEnumerator that can be used to iterate through the rows in the data reader.

GetFieldType(Int32) GetFieldType(Int32) GetFieldType(Int32) GetFieldType(Int32)

Obtient le Type qui correspond au type de données de l'objet.Gets the Type that is the data type of the object.

GetFloat(Int32) GetFloat(Int32) GetFloat(Int32) GetFloat(Int32)

Obtient la valeur de la colonne spécifiée sous la forme d'un nombre à virgule flottante simple précision.Gets the value of the specified column as a single-precision floating-point number.

GetGuid(Int32) GetGuid(Int32) GetGuid(Int32) GetGuid(Int32)

Obtient la valeur de la colonne spécifiée sous la forme d'un identificateur global unique (GUID, Globally-Unique IDentifier).Gets the value of the specified column as a globally unique identifier (GUID).

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fait office de fonction de hachage par défaut.Serves as the default hash function.

(Inherited from Object)
GetInt16(Int32) GetInt16(Int32) GetInt16(Int32) GetInt16(Int32)

Obtient la valeur de la colonne spécifiée sous la forme d'un entier signé 16 bits.Gets the value of the specified column as a 16-bit signed integer.

GetInt32(Int32) GetInt32(Int32) GetInt32(Int32) GetInt32(Int32)

Obtient la valeur de la colonne spécifiée sous la forme d’un entier signé 32 bits.Gets the value of the specified column as a 32-bit signed integer.

GetInt64(Int32) GetInt64(Int32) GetInt64(Int32) GetInt64(Int32)

Obtient la valeur de la colonne spécifiée sous la forme d'un entier signé 64 bits.Gets the value of the specified column as a 64-bit signed integer.

GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

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.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetName(Int32) GetName(Int32) GetName(Int32) GetName(Int32)

Obtient le nom de la colonne spécifiée.Gets the name of the specified column.

GetOrdinal(String) GetOrdinal(String) GetOrdinal(String) GetOrdinal(String)

Obtient le numéro de la colonne, en fonction du nom de la colonne.Gets the column ordinal, given the name of the column.

GetSchemaTable() GetSchemaTable() GetSchemaTable() GetSchemaTable()

Retourne un DataTable qui décrit les métadonnées de colonne de OleDbDataReader.Returns a DataTable that describes the column metadata of the OleDbDataReader.

GetString(Int32) GetString(Int32) GetString(Int32) GetString(Int32)

Obtient la valeur de la colonne spécifiée sous la forme d'une chaîne.Gets the value of the specified column as a string.

GetTimeSpan(Int32) GetTimeSpan(Int32) GetTimeSpan(Int32) GetTimeSpan(Int32)

Obtient la valeur de la colonne spécifiée sous la forme d'un objet TimeSpan.Gets the value of the specified column as a TimeSpan object.

GetType() GetType() GetType() GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Inherited from Object)
GetValue(Int32) GetValue(Int32) GetValue(Int32) GetValue(Int32)

Obtient la valeur de la colonne au numéro spécifié dans son format natif.Gets the value of the column at the specified ordinal in its native format.

GetValues(Object[]) GetValues(Object[]) GetValues(Object[]) GetValues(Object[])

Remplit un tableau d'objets avec les valeurs de colonne de la ligne en cours.Populates an array of objects with the column values of the current row.

InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() 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.Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
IsDBNull(Int32) IsDBNull(Int32) IsDBNull(Int32) IsDBNull(Int32)

Obtient une valeur qui indique si la colonne contient des valeurs inexistantes ou manquantes.Gets a value that indicates whether the column contains nonexistent or missing values.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crée une copie superficielle de l'objet Object actuel.Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

Crée une copie superficielle de l'objet MarshalByRefObject actuel.Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
NextResult() NextResult() NextResult() NextResult()

Avance le lecteur de données jusqu’au résultat suivant lors de la lecture des résultats d’instructions SQL par lots.Advances the data reader to the next result, when reading the results of batch SQL statements.

Read() Read() Read() Read()

Fait passer le OleDbDataReader à l’enregistrement suivant.Advances the OleDbDataReader to the next record.

ToString() ToString() ToString() ToString()

Retourne une chaîne qui représente l'objet actuel.Returns a string that represents the current object.

(Inherited from Object)

Implémentations d’interfaces explicites

IDataRecord.GetData(Int32) IDataRecord.GetData(Int32) IDataRecord.GetData(Int32) IDataRecord.GetData(Int32)

Retourne un IDataReader pour le numéro de colonne spécifié.Returns an IDataReader for the specified column ordinal.

IDisposable.Dispose() IDisposable.Dispose() IDisposable.Dispose() IDisposable.Dispose()

Libère les ressources utilisées par l'instance actuelle de la classe OleDbDataReader.Releases the resources used by the current instance of the OleDbDataReader class.

IEnumerable.GetEnumerator() IEnumerable.GetEnumerator() IEnumerable.GetEnumerator() IEnumerable.GetEnumerator()

Retourne un énumérateur qui itère au sein d’une collection.Returns an enumerator that iterates through a collection.

S’applique à

Voir aussi