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. Cette classe ne peut pas être héritée.

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 . L’exemple lit les données, en les écrivant dans la console. Enfin, l’exemple ferme le OdbcDataReader , puis le 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.

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. C’est le cas jusqu’à ce que la Close méthode du OdbcDataReader soit appelée. 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 pour l'utilisateur de l'élément OdbcDataReader. Toutefois, le comportement précis dépend à la fois du pilote et du minutage.

IsClosed et RecordsAffected sont les seules propriétés pouvant être appelées après la fermeture de l'élément OdbcDataReader. Parfois, vous devez appeler Close avant de pouvoir appeler RecordsAffected .

Propriétés

Depth

Obtient une valeur qui indique la profondeur d'imbrication de la ligne actuelle.

FieldCount

Obtient le nombre de colonnes figurant dans la ligne actuelle.

HasRows

Obtient une valeur qui indique si OdbcDataReader contient une ou plusieurs lignes.

IsClosed

Indique si OdbcDataReader 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 modifiées, inséré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 l'objet OdbcDataReader.

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

GetBoolean(Int32)

Obtient la valeur de la colonne spécifiée sous la forme d'une valeur 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écifique.

GetChar(Int32)

Obtient la valeur de la colonne spécifiée sous la forme d'un caractère.

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.

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 IDataReader pour le numéro de colonne spécifié.

GetData(Int32)

Retourne un lecteur de données imbriqué pour la colonne demandée.

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

Obtient le nom du type de données source.

GetDate(Int32)

Obtient la valeur de la colonne spécifiée sous la forme d'un objet DateTime.

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 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 objet IEnumerator qui peut être utilisé pour itérer au sein des lignes dans le lecteur de données.

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 forme d’identificateur global unique (GUID).

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 le nom de la colonne spécifiée.

GetOrdinal(String)

Obtient le numéro de la 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 sous forme d’une instance d’un type spécifique au fournisseur.

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

Obtient toutes les colonnes d’attributs spécifiques au fournisseur figurant dans la collection de la ligne actuelle.

(Hérité de DbDataReader)
GetSchemaTable()

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

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'un String.

GetTextReader(Int32)

Obtient un lecteur de texte pour récupérer les données de la colonne.

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

Obtient la valeur de la colonne spécifiée sous la forme d'un objet TimeSpan.

GetType()

Obtient le Type de l'instance actuelle.

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

Obtient la valeur de la colonne au numéro spécifié 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 OdbcDataReader jusqu'au résultat suivant, lors de la lecture des résultats d'instructions SQL par lots.

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 OdbcDataReader à 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

IDataReader.Close()

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

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

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

(Hérité de DbDataReader)
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 toutes les ressources utilisées par l'instance actuelle de la classe OdbcDataReader.

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.

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.

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.

S’applique à

Voir aussi