SqlCeDataReader.Read Method

Sposta l'oggetto SqlCeDataReader al record successivo.

Spazio dei nomi: System.Data.SqlServerCe
Assembly: System.Data.SqlServerCe (in system.data.sqlserverce.dll)

Sintassi

'Dichiarazione
Public Overrides Function Read As Boolean

public override bool Read ()

public:
virtual bool Read () override

public boolean Read ()

public override function Read () : boolean

Valore restituito

true se sono presenti più righe. In caso contrario, false.

Osservazioni

La posizione predefinita dell'interfaccia SqlCeDataReader è precedente al primo record. Per iniziare l'accesso ai dati, è necessario chiamare il metodo Read. La posizione predefinita dell'interfaccia SqlCeResultSet è il primo record. Se si chiama il metodo SqlCeResultSet.Read subito dopo la creazione di SqlCeResultSet, il cursore si sposterà sul secondo record. Il comportamento del metodo SqlCeDataReader.Read è diverso rispetto a quello del metodo SqlCeResultSet.Read.

Quando l'oggetto SqlCeDataReader è in uso, l'oggetto SqlCeConnection associato è occupato finché non viene chiamato il metodo Close.

Esempio

Nell'esempio che segue vengono creati un oggetto SqlCeConnection, un oggetto SqlCeCommand e un oggetto SqlCeDataReader. Nell'esempio i dati vengono letti e poi scritti nella console. Infine, vengono chiusi l'oggetto SqlCeDataReader e quindi l'oggetto 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();
}

Affidabilità

Tutti i membri statici pubblici (Shared in Microsoft Visual Basic) di questo tipo sono affidabili. Non è invece garantita l'affidabilità dei membri dell'istanza.

Piattaforme

Piattaforme di sviluppo

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
Informazioni sulla versione
.NET Framework e .NET Compact Framework
Supportato in 3.5
.NET Framework
Supportato in 3.0
.NET Compact Framework e .NET Framework
Supportato in 2.0

Vedere anche

Riferimento

SqlCeDataReader Class
SqlCeDataReader Members
System.Data.SqlServerCe Namespace