SqlDataReader.Read Metoda

Definicja

Przestrzeń nazw:

Microsoft.Data.SqlClient

Zestaw:

Microsoft.Data.SqlClient.dll

Pakiet:

Microsoft.Data.SqlClient v5.2.0

SqlDataReader Przechodzi do następnego rekordu.

public:
 override bool Read();

public override bool Read ();

override this.Read : unit -> bool

Public Overrides Function Read () As Boolean

Zwraca

Boolean

true jeśli jest więcej wierszy; w przeciwnym razie false.

Implementuje

Read()

Wyjątki

SqlException

SQL Server zwrócił błąd podczas wykonywania tekstu polecenia.

Przykłady

Poniższy przykład tworzy obiekt SqlConnection, , SqlCommandi SqlDataReader. Przykład odczytuje dane, zapisuj je w oknie konsoli. Następnie kod zamyka element SqlDataReader. Element SqlConnection jest zamykany automatycznie na końcu using bloku kodu.

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]));
    }

}

Uwagi

Domyślna pozycja obiektu SqlDataReader znajduje się przed pierwszym rekordem. W związku z tym należy wywołać metodę Read , aby rozpocząć uzyskiwanie dostępu do dowolnych danych.

Tylko jedna SqlDataReader skojarzona SqlConnection może być otwarta w danym momencie, a każda próba otwarcia innego zakończy się niepowodzeniem, dopóki pierwszy z nich nie zostanie zamknięty. Podobnie, gdy SqlDataReader element jest używany, skojarzony SqlConnection jest zajęty obsługą go do momentu wywołania metody Close.