Método SqlCeDataReader.Read

Artigo
05/27/2011

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

Namespace: System.Data.SqlServerCe
Assembly: System.Data.SqlServerCe (em System.Data.SqlServerCe.dll)

Sintaxe

'Declaração
Public Overrides Function Read As Boolean
'Uso
Dim instance As SqlCeDataReader
Dim returnValue As Boolean

returnValue = instance.Read()

public override bool Read()

public:
virtual bool Read() override

abstract Read : unit -> bool 
override Read : unit -> bool

public override function Read() : boolean

Valor de retorno

Tipo: System.Boolean
true se houver mais linhas; caso contrário, false.

Implementa

IDataReader.Read()

Comentários

A posição padrão de SqlCeDataReader é antes do primeiro registro. Para começar a acessar qualquer dado, chame Read. A posição padrão de SqlCeResultSet é o primeiro registro. A chamada do método SqlCeResultSet.Read imediatamente após a criação de SqlCeResultSet moverá o cursor para o segundo registro. Para SqlCeDataReader.Read, o comportamento é diferente de SqlCeResultSet.Read.

Enquanto o SqlCeDataReaderestá sendo usado, o SqlCeConnection associado está ocupado atendendo-o, até você chamar Close.

Exemplos

O exemplo a seguir cria uma SqlCeConnection, um SqlCeCommand e um SqlCeDataReader. O exemplo lê os dados e os grava no console. Por fim, o exemplo fecha o SqlCeDataReader e, em seguida, a SqlCeConnection.

Dim conn As SqlCeConnection = Nothing
Dim cmd As SqlCeCommand = Nothing
Dim rdr As SqlCeDataReader = Nothing

Try
    ' Open the connection and create a SQL command
    '
    conn = New SqlCeConnection("Data Source = AdventureWorks.sdf")
    conn.Open()

    cmd = New SqlCeCommand("SELECT * FROM DimEmployee", conn)

    rdr = cmd.ExecuteReader()

    ' Iterate through the results
    '
    While rdr.Read()
        Dim employeeID As Integer = rdr.GetInt32(0) ' or: rdr["EmployeeKey"];
        Dim lastName As String = rdr.GetString(5) ' or: rdr["FirstName"];
    End While

    ' Always dispose data readers and commands as soon as practicable
    '
    rdr.Close()
    cmd.Dispose()
Finally
    ' Close the connection when no longer needed
    '
    conn.Close()
End Try

SqlCeConnection conn = null;
SqlCeCommand cmd = null;
SqlCeDataReader rdr = null;

try
{
    // Open the connection and create a SQL command
    //
    conn = new SqlCeConnection("Data Source = AdventureWorks.sdf");
    conn.Open();

    cmd = new SqlCeCommand("SELECT * FROM DimEmployee", conn);

    rdr = cmd.ExecuteReader();

    // Iterate through the results
    //
    while (rdr.Read())
    {
        int employeeID = rdr.GetInt32(0);   // or: rdr["EmployeeKey"];
        string lastName = rdr.GetString(5); // or: rdr["FirstName"];
    }

    // Always dispose data readers and commands as soon as practicable
    //
    rdr.Close();
    cmd.Dispose();
}
finally
{
    // Close the connection when no longer needed
    //
    conn.Close();
}

Consulte também

Referência

SqlCeDataReader Classe

Namespace System.Data.SqlServerCe

Partilhar via