OdbcDataReader Classe

Définition

Espace de noms:
System.Data.Odbc
Assembly:
System.Data.dll

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

Exemples

L’exemple suivant crée un OdbcConnection, un OdbcCommandet un OdbcDataReader. L’exemple lit les données, en l’écrivant dans la console. Enfin, l’exemple ferme , OdbcDataReaderpuis 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’objet OdbcCommand , au lieu d’utiliser directement un constructeur.

Pendant l’utilisation OdbcDataReader , l’associé OdbcConnection est occupé à servir le OdbcDataReader, et aucune autre opération ne peut être effectuée sur l’autre que la OdbcConnection fermeture. C’est le cas jusqu’à ce que la Close méthode de l’objet OdbcDataReader soit appelée. Par exemple, vous ne pouvez pas récupérer les paramètres de sortie tant qu’après l’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 du OdbcDataReader. Toutefois, le comportement précis dépend à la fois du pilote et du minutage.

IsClosed et RecordsAffected sont les seules propriétés que vous pouvez appeler après la OdbcDataReader fermeture. Parfois, vous devez appeler Close avant de pouvoir appeler RecordsAffected.

Propriétés

Nom Description
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 les OdbcDataReader lignes contiennent une ou plusieurs lignes.
IsClosed

Indique si l’objet OdbcDataReader 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 les DbDataReader champs qui ne sont pas masqués.

(Hérité de DbDataReader)

Méthodes

Nom Description
Close()

Ferme l’objet OdbcDataReader .
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 DbDataReader classe.

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

Libère les ressources non managées utilisées par les DbDataReader ressources gérées et libère éventuellement les ressources managées.

(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, en commençant par le décalage de mémoire tampon spécifique.
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, en commençant par le décalage de mémoire tampon particulier.
GetData(Int32)

Retourne un IDataReader ordinal 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 en tant qu’objet DateTime .
GetDateTime(Int32)

Obtient la valeur de la colonne spécifiée en tant qu’objet DateTime .
GetDbDataReader(Int32)

Retourne un DbDataReader objet pour l’ordinal de colonne demandée 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 une valeur qui peut être utilisée pour effectuer une IEnumerator itération dans les lignes du lecteur de données.
GetFieldType(Int32)

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

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 une DataTable valeur qui décrit les métadonnées de colonne du OdbcDataReader.
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 en tant que String.
GetTextReader(Int32)

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

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

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

(Hérité de MarshalByRefObject)
NextResult()

Avance le OdbcDataReader 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 OdbcDataReader dossier suivant.
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

Nom Description
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 OdbcDataReader classe.
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 dans une collection.

Méthodes d’extension

Nom Description
AsParallel(IEnumerable)

Active la parallélisation d’une requête.
AsQueryable(IEnumerable)

Convertit un IEnumerable en IQueryable.
CanGetColumnSchema(DbDataReader)

Obtient une valeur qui indique si un DbDataReader schéma de colonne peut être obtenu.
Cast<TResult>(IEnumerable)

Convertit les éléments d’un IEnumerable en type spécifié.
GetColumnSchema(DbDataReader)

Obtient le schéma de colonne (DbColumn collection) d’un DbDataReader.
OfType<TResult>(IEnumerable)

Filtre les éléments d’une IEnumerable en fonction d’un type spécifié.

S’applique à

Voir aussi