SqlDataReader.Read Метод

Определение

Пространство имен:

System.Data.SqlClient

Сборка:

System.Data.dll

Перемещает SqlDataReader к следующей записи.

public:
 override bool Read();

public override bool Read ();

override this.Read : unit -> bool

Public Overrides Function Read () As Boolean

Возвращаемое значение

Boolean

Значение true, если имеются другие строки; в противном случае — значение false.

Реализации

Read()

Исключения

SqlException

SQL Server вернул ошибку во время выполнения текста команды.

Примеры

В следующем примере создаются SqlConnection, и SqlCommandSqlDataReader. Пример считывает данные, записывая их в окно консоли. Затем код закрывает SqlDataReader. Автоматически SqlConnection закрывается в конце using блока кода.

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 dataRecord)
{
    Console.WriteLine(String.Format("{0}, {1}", dataRecord[0], dataRecord[1]));
}

Private Sub ReadOrderData(ByVal connectionString As String)
    Dim queryString As String = _
        "SELECT OrderID, CustomerID FROM dbo.Orders;"

    Using connection As New SqlConnection(connectionString)
        Dim command As New SqlCommand(queryString, connection)
        connection.Open()

        Dim reader As SqlDataReader = command.ExecuteReader()

        ' Call Read before accessing data.
        While reader.Read()
            ReadSingleRow(CType(reader, IDataRecord))
        End While

        ' Call Close when done reading.
        reader.Close()
    End Using
End Sub

Private Sub ReadSingleRow(ByVal record As IDataRecord)
   Console.WriteLine(String.Format("{0}, {1}", record(0), record(1)))
End Sub

Комментарии

Позиция по умолчанию SqlDataReader — перед первой записью. Поэтому необходимо вызвать , Read чтобы начать доступ к любым данным.

Одновременно может быть открыто только одно SqlDataReaderSqlConnection связанное, и любая попытка открыть другую будет завершаться ошибкой, пока первая из них не будет закрыта. Аналогичным образом, пока SqlDataReader используется , связанный SqlConnection объект занят обслуживанием до тех пор, пока вы не вызовете Close.

См. также раздел

• Объединение подключений в пул в SQL Server (ADO.NET)
• Объекты DataAdapter и DataReader
• SQL Server и ADO.NET
• Общие сведения об ADO.NET