SqlDataReader.Read Méthode

Définition

Espace de noms:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Paquet:

Microsoft.Data.SqlClient v5.2.0

Fait passer le SqlDataReader à l’enregistrement suivant.

public:
 override bool Read();

public override bool Read ();

override this.Read : unit -> bool

Public Overrides Function Read () As Boolean

Retours

Boolean

true s’il existe des lignes supplémentaires ; sinon, false.

Implémente

Read()

Exceptions

SqlException

SQL Server a retourné une erreur pendant l’exécution du texte de commande.

Exemples

L’exemple suivant crée un SqlConnection, un SqlCommandet un SqlDataReader. L’exemple lit les données et les écrit dans la fenêtre de console. Le code ferme ensuite .SqlDataReader est SqlConnection fermé automatiquement à la fin du bloc de using code.

using Microsoft.Data.SqlClient;

class Program
{
    static void Main()
    {
        string str = "Data Source=(local);Initial Catalog=Northwind;"
            + "Integrated Security=SSPI";
        ReadOrderData(str);
    }

    private static void ReadOrderData(string connectionString)
    {
        string queryString =
            "SELECT OrderID, CustomerID FROM dbo.Orders;";

        using (SqlConnection connection =
                   new SqlConnection(connectionString))
        {
            SqlCommand command =
                new SqlCommand(queryString, connection);
            connection.Open();

            SqlDataReader reader = command.ExecuteReader();

            // Call Read before accessing data.
            while (reader.Read())
            {
                ReadSingleRow((IDataRecord)reader);
            }

            // Call Close when done reading.
            reader.Close();
        }
    }

    private static void ReadSingleRow(IDataRecord record)
    {
        Console.WriteLine(String.Format("{0}, {1}", record[0], record[1]));
    }

}

Remarques

La position par défaut du SqlDataReader est avant le premier enregistrement. Par conséquent, vous devez appeler Read pour commencer à accéder aux données.

SqlDataReader Un seul par associé SqlConnection peut être ouvert à la fois, et toute tentative d’ouverture d’un autre peut échouer jusqu’à ce que la première soit fermée. De même, pendant que le SqlDataReader est utilisé, le associé SqlConnection est occupé à le traiter jusqu’à ce que vous appeliez Close.