IDataReader.Read Método

Definição

Namespace:

System.Data

Assembly:

System.Data.Common.dll

Assembly:

System.Data.dll

Assembly:

netstandard.dll

Avança o IDataReader para o próximo registro.

public:
 bool Read();

public bool Read ();

abstract member Read : unit -> bool

Public Function Read () As Boolean

Retornos

Boolean

true se houver mais linhas; caso contrário, false.

Exemplos

O exemplo a seguir cria instâncias de três classes OleDbConnectionderivadas, uma OleDbCommande uma OleDbDataReader. O exemplo lê os dados, escrevendo-os no console. Por fim, o exemplo fecha o OleDbDataReader.OleDbConnection

private static void ReadData(string connectionString)
{
    string queryString = "SELECT OrderID, CustomerID FROM Orders";
    using (OracleConnection connection = new OracleConnection(connectionString))
    {
        OracleCommand command = new OracleCommand(queryString, connection);
        connection.Open();
        OracleDataReader reader;
        reader = command.ExecuteReader();

        // Always call Read before accessing data.
        while (reader.Read())
        {
            Console.WriteLine(reader.GetInt32(0) + ", " + reader.GetString(1));
        }

        // Always call Close when done reading.
        reader.Close();
    }
}

Public Sub ReadData(ByVal connectionString As String)
    Dim queryString As String = _
        "SELECT OrderID, CustomerID FROM Orders"

    Using connection As New OracleConnection(connectionString)
        Dim command As New OracleCommand(queryString, connection)
        connection.Open()

        Dim reader As OracleDataReader
        reader = command.ExecuteReader()

        ' Always call Read before accessing data.
        While reader.Read()
            Console.WriteLine(reader.GetInt32(0) & ", " & reader.GetString(1))
        End While

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

Comentários

A posição padrão do IDataReader é anterior ao primeiro registro. Portanto, você deve chamar Read para começar a acessar quaisquer dados.

Enquanto o leitor de dados está em uso, a conexão associada está ocupada atendendo a IDataReader. Esse é o caso até Close que seja chamado.