OdbcDataReader, classe

OdbcDataReader, classe

Mise à jour : novembre 2007

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.

Espace de noms :  System.Data.Odbc
Assembly :  System.Data (dans System.Data.dll)

public sealed class OdbcDataReader : DbDataReader
public final class OdbcDataReader extends DbDataReader
public final class OdbcDataReader extends DbDataReader

Pour créer OdbcDataReader, vous devez appeler la méthode ExecuteReader de l'objet OdbcCommand, plutôt que d'utiliser directement un constructeur.

Lorsque OdbcDataReader est en cours d'utilisation, le OdbcConnection qui lui est associé est occupé à servir OdbcDataReader et aucune autre opération ne peut être effectuée sur OdbcConnection, à l'exception de sa fermeture. Cette situation subsiste jusqu'à ce que la méthode Close de OdbcDataReader soit appelée. Par exemple, vous ne pouvez pas récupérer de 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 OdbcDataReader. Cependant, 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 OdbcDataReader. Parfois, vous devez appeler Close avant d'appeler RecordsAffected.

L'exemple suivant crée OdbcConnection, OdbcCommand et OdbcDataReader. L'exemple lit les données, en les écrivant dans la console. Pour terminer, l'exemple ferme OdbcDataReader, puis 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();
    }
}


Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professionnel Édition x64, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

.NET Framework

Pris en charge dans : 3.5, 3.0, 2.0, 1.1

Ajouts de la communauté

AJOUTER
Afficher:
© 2016 Microsoft