OdbcDataReader Classe

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 OdbcDataReader sealed : System::Data::Common::DbDataReader
public ref class OdbcDataReader sealed : MarshalByRefObject, IDisposable, System::Collections::IEnumerable, System::Data::IDataReader
public sealed class OdbcDataReader : System.Data.Common.DbDataReader
public sealed class OdbcDataReader : MarshalByRefObject, IDisposable, System.Collections.IEnumerable, System.Data.IDataReader
type OdbcDataReader = class
    inherit DbDataReader
type OdbcDataReader = class
    inherit MarshalByRefObject
    interface IDataReader
    interface IDataRecord
    interface IDisposable
    interface IEnumerable
Public NotInheritable Class OdbcDataReader
Inherits DbDataReader
Public NotInheritable Class OdbcDataReader
Inherits MarshalByRefObject
Implements IDataReader, IDisposable, IEnumerable
Héritage
OdbcDataReader
Héritage
Héritage
OdbcDataReader
Implémente

Exemples

L’exemple suivant crée un OdbcConnection , un OdbcCommand et un OdbcDataReader .The following example creates an OdbcConnection, an OdbcCommand, and an OdbcDataReader. 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 OdbcDataReader , puis le OdbcConnection .Finally, the example closes the OdbcDataReader, and then the OdbcConnection.

public static void ReadData(string connectionString)
{
    string queryString = "SELECT DISTINCT CustomerID FROM Orders";

    using (OdbcConnection connection = new OdbcConnection(connectionString))
    {
        OdbcCommand command = new OdbcCommand(queryString, connection);

        connection.Open();

        // Execute the DataReader and access the data.
        OdbcDataReader reader = command.ExecuteReader();
        while (reader.Read())
        {
            Console.WriteLine("CustomerID={0}", reader[0]);
        }

        // Call Close when done reading.
        reader.Close();
    }
}
Public Sub ReadData(ByVal connectionString As String)
    Dim queryString As String = "SELECT DISTINCT CustomerID FROM Orders"

    Using connection As New OdbcConnection(connectionString)
        Dim command As New OdbcCommand(queryString, connection)

        connection.Open()

        Dim reader As OdbcDataReader = command.ExecuteReader()

        While reader.Read()
            Console.WriteLine("CustomerID={0}", reader(0).ToString)
        End While

        ' Call Close when done reading.
        reader.Close()
    End Using
End Sub

Remarques

Pour créer un OdbcDataReader , vous devez appeler la ExecuteReader méthode de l' OdbcCommand objet au lieu d’utiliser directement un constructeur.To create an OdbcDataReader, you must call the ExecuteReader method of the OdbcCommand object, instead of directly using a constructor.

Pendant l' OdbcDataReader utilisation de, le associé OdbcConnection est occupé à servir le OdbcDataReader , et aucune autre opération ne peut être effectuée sur l' OdbcConnection autre que le fermer.While the OdbcDataReader is being used, the associated OdbcConnection is busy serving the OdbcDataReader, and no other operations can be performed on the OdbcConnection other than closing it. C’est le cas jusqu’à ce que la Close méthode du OdbcDataReader soit appelée.This is the case until the Close method of the OdbcDataReader is called. Par exemple, vous ne pouvez pas récupérer les paramètres de sortie tant que vous n’avez pas appelé Close .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 pour l'utilisateur de l'élément OdbcDataReader.Changes made to a result set by another process or thread while data is being read may be visible to the user of the OdbcDataReader. Toutefois, le comportement précis dépend à la fois du pilote et du minutage.However, the precise behavior is both driver and timing dependent.

IsClosed et RecordsAffected sont les seules propriétés pouvant être appelées après la fermeture de l'élément OdbcDataReader.IsClosed and RecordsAffected are the only properties that you can call after the OdbcDataReader is closed. Parfois, vous devez appeler Close avant de pouvoir appeler RecordsAffected .Sometimes, you must call Close before you can call RecordsAffected.

Propriétés

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

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

HasRows

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

IsClosed

Indique si OdbcDataReader est fermé.Indicates whether the OdbcDataReader is closed.

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]

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

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

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

(Hérité de DbDataReader)

Méthodes

Close()

Ferme l'objet OdbcDataReader.Closes the OdbcDataReader object.

CloseAsync()

Ferme de façon asynchrone l’objet DbDataReader.Asynchronously closes the DbDataReader object.

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

(Hérité de MarshalByRefObject)
Dispose()

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

(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.Releases the unmanaged resources used by the DbDataReader and optionally releases the managed resources.

(Hérité de DbDataReader)
DisposeAsync()

Libère de façon asynchrone toutes les ressources utilisées par l’instance actuelle de la classe DbDataReader.Asynchronously releases all resources used by the current instance of the DbDataReader class.

(Hérité de DbDataReader)
Equals(Object)

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

(Hérité de Object)
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)

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)

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)

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écifique.Reads a stream of bytes from the specified column offset into the buffer as an array, starting at the particular buffer offset.

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)

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 spécifique.Reads a stream of characters from the specified column offset into the buffer as an array, starting at the particular buffer offset.

GetColumnSchemaAsync(CancellationToken)

Il s'agit de la version asynchrone de GetColumnSchema(DbDataReader).This is the asynchronous version of GetColumnSchema(DbDataReader). Les fournisseurs doivent effectuer le remplacement avec une implémentation appropriée.Providers should override with an appropriate implementation. Le cancellationToken peut éventuellement être respecté.The cancellationToken can optionally be honored. L'implémentation par défaut appelle l'appel de méthode GetColumnSchema(DbDataReader) synchrone et retourne une tâche terminée.The default implementation invokes the synchronous GetColumnSchema(DbDataReader) call and returns a completed task. L'implémentation par défaut retourne une tâche annulée si un cancellationToken déjà annulé est passé.The default implementation will return a cancelled task if passed an already cancelled cancellationToken. Les exceptions levées par GetColumnSchema(DbDataReader) sont communiquées via la propriété d'exception de tâche retournée.Exceptions thrown by GetColumnSchema(DbDataReader) will be communicated via the returned Task Exception property.

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

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

GetData(Int32)

Retourne un lecteur de données imbriqué pour la colonne demandée.Returns a nested data reader for the requested column.

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

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

GetDate(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.

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.

GetDbDataReader(Int32)

Retourne un objet DbDataReader pour l'ordinal de colonne demandé qui peut être substitué par une implémentation spécifique au fournisseur.Returns a DbDataReader object for the requested column ordinal that can be overridden with a provider-specific implementation.

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

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()

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)

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

GetFieldValue<T>(Int32)

Obtient la valeur de la colonne spécifiée comme type demandé.Gets the value of the specified column as the requested type.

(Hérité de DbDataReader)
GetFieldValueAsync<T>(Int32)

Obtient de manière asynchrone la valeur de la colonne spécifiée comme type demandé.Asynchronously gets the value of the specified column as the requested type.

(Hérité de DbDataReader)
GetFieldValueAsync<T>(Int32, CancellationToken)

Obtient de manière asynchrone la valeur de la colonne spécifiée comme type demandé.Asynchronously gets the value of the specified column as the requested type.

(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.Gets the value of the specified column as a single-precision floating-point number.

GetGuid(Int32)

Obtient la valeur de la colonne spécifiée sous forme d’identificateur global unique (GUID).Gets the value of the specified column as a globally unique identifier (GUID).

GetHashCode()

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

(Hérité de Object)
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)

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)

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

(Hérité de MarshalByRefObject)
GetName(Int32)

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

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.

GetProviderSpecificFieldType(Int32)

Obtient le type spécifique au fournisseur de la colonne spécifiée.Gets the provider-specific type of the specified column.

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

Obtient la valeur de la colonne spécifiée sous forme d’une instance d’un type spécifique au fournisseur.Gets the value of the specified column as an instance of a provider-specific type.

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

Obtient toutes les colonnes d’attributs spécifiques au fournisseur figurant dans la collection de la ligne actuelle.Gets all provider-specific attribute columns in the collection for the current row.

(Hérité de DbDataReader)
GetSchemaTable()

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

GetSchemaTableAsync(CancellationToken)

Il s'agit de la version asynchrone de GetSchemaTable().This is the asynchronous version of GetSchemaTable(). Les fournisseurs doivent effectuer le remplacement avec une implémentation appropriée.Providers should override with an appropriate implementation. Le cancellationToken peut éventuellement être respecté.The cancellationToken can optionally be honored. L'implémentation par défaut appelle l'appel de méthode GetSchemaTable() synchrone et retourne une tâche terminée.The default implementation invokes the synchronous GetSchemaTable() call and returns a completed task. L'implémentation par défaut retourne une tâche annulée si un cancellationToken déjà annulé est passé.The default implementation will return a cancelled task if passed an already cancelled cancellationToken. Les exceptions levées par GetSchemaTable() sont communiquées via la propriété d'exception de tâche retournée.Exceptions thrown by GetSchemaTable() will be communicated via the returned Task Exception property.

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

Obtient un flux pour récupérer les données de la colonne spécifiée.Gets a stream to retrieve data from the specified column.

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

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

GetTextReader(Int32)

Obtient un lecteur de texte pour récupérer les données de la colonne.Gets a text reader to retrieve data from the column.

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

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

(Hérité de Object)
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[])

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

(Hérité de MarshalByRefObject)
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.

IsDBNullAsync(Int32)

Obtient de manière asynchrone une valeur qui indique si la colonne contient des valeurs inexistantes ou manquantes.Asynchronously gets a value that indicates whether the column contains non-existent or missing values.

(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.Asynchronously gets a value that indicates whether the column contains non-existent or missing values.

(Hérité de DbDataReader)
MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
MemberwiseClone(Boolean)

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

(Hérité de MarshalByRefObject)
NextResult()

Avance OdbcDataReader jusqu'au résultat suivant, lors de la lecture des résultats d'instructions SQL par lots.Advances the OdbcDataReader to the next result when reading the results of batch SQL statements.

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.Asynchronously advances the reader to the next result when reading the results of a batch of statements.

(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.Asynchronously advances the reader to the next result when reading the results of a batch of statements.

(Hérité de DbDataReader)
Read()

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

ReadAsync()

Avance le lecteur de manière asynchrone jusqu’à l’enregistrement suivant d’un jeu de résultats.Asynchronously advances the reader to the next record in a result set.

(Hérité de DbDataReader)
ReadAsync(CancellationToken)

Avance le lecteur de manière asynchrone jusqu’à l’enregistrement suivant d’un jeu de résultats.Asynchronously advances the reader to the next record in a result set.

(Hérité de DbDataReader)
ToString()

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

(Hérité de Object)

Implémentations d’interfaces explicites

IDataReader.Close()

Pour obtenir une description de ce membre, consultez Close().For a description of this member, see Close().

(Hérité de DbDataReader)
IDataReader.GetSchemaTable()

Pour obtenir une description de ce membre, consultez GetSchemaTable().For a description of this member, see GetSchemaTable().

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

Pour obtenir une description de ce membre, consultez GetData(Int32).For a description of this member, see 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 toutes les ressources utilisées par l'instance actuelle de la classe OdbcDataReader.Releases all resources used by the current instance of the OdbcDataReader class.

IEnumerable.GetEnumerator()

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

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

Méthodes d’extension

CanGetColumnSchema(DbDataReader)

Obtient une valeur qui indique si un DbDataReader peut obtenir un schéma de colonne.Gets a value that indicates whether a DbDataReader can get a column schema.

GetColumnSchema(DbDataReader)

Obtient le schéma de colonne (collection DbColumn) pour un DbDataReader.Gets the column schema (DbColumn collection) for a DbDataReader.

Cast<TResult>(IEnumerable)

Effectue un cast des éléments d'un IEnumerable vers le type spécifié.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtre les éléments d'un IEnumerable en fonction du type spécifié.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Active la parallélisation d'une requête.Enables parallelization of a query.

AsQueryable(IEnumerable)

Convertit un IEnumerable en IQueryable.Converts an IEnumerable to an IQueryable.

S’applique à