SqlCeDataReader.Read Method

Artigo
01/14/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

public override bool Read ()

public:
virtual bool Read () override

public boolean Read ()

public override function Read () : boolean

Valor de retorno

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

Comentários

A posição padrão do SqlCeDataReader é anterior ao 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.

Exemplo

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

Segurança de thread

Quaisquer membros estáticos públicos (compartilhados no Microsoft Visual Basic) desse tipo são thread safe. Não há garantia de que qualquer membro de instância seja thread safe.

Plataformas

Plataformas de desenvolvimento

Windows Vista, Windows Mobile 5.0, Windows XP Professional with Service Pack 2 (SP2), Windows Server 2003, Windows Mobile 2003 for Pocket PC, Windows CE 5.0
Informações de versão
.NET Framework e NET Compact Framework
Com suporte no 3.5
.NET Framework
Com suporte no 3.0
.NET Compact Framework e .Net Framework
Com suporte no 2.0

Consulte também

Referência

SqlCeDataReader Class
SqlCeDataReader Members
System.Data.SqlServerCe Namespace

Compartilhar via