SqlCeDataReader Class

Articolo
01/14/2011

Fornisce un modo per leggere un flusso di righe di dati forward-only da un'origine dati. Questa classe non può essere ereditata.

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

Sintassi

'Dichiarazione
<DefaultMemberAttribute("Item")> _
Public Class SqlCeDataReader
    Inherits DbDataReader

[DefaultMemberAttribute("Item")] 
public class SqlCeDataReader : DbDataReader

[DefaultMemberAttribute(L"Item")] 
public ref class SqlCeDataReader : public DbDataReader

/** @attribute DefaultMemberAttribute("Item") */ 
public class SqlCeDataReader extends DbDataReader

DefaultMemberAttribute("Item") 
public class SqlCeDataReader extends DbDataReader

Osservazioni

Per creare un oggetto SqlCeDataReader, è necessario chiamare il metodo ExecuteReader dell'oggetto SqlCeCommand, anziché utilizzare direttamente un costruttore.

Mentre l'oggetto SqlCeDataReader è in uso, l'oggetto SqlCeConnection associato è occupato nel rendere disponibile l'oggetto SqlCeDataReader. In questo stato, è possibile creare più visualizzatori nella stessa connessione.

Le modifiche apportate a un gruppo di risultati da un altro processo o thread durante la lettura dei dati sono visibili agli utenti di SqlCeDataReader, tuttavia il comportamento preciso dipende da quando vengono apportate.

IsClosed e RecordsAffected sono le uniche proprietà che è possibile chiamare dopo la chiusura dell'oggetto SqlCeDataReader. Anche se è possibile accedere alla proprietà RecordsAffected in qualsiasi momento in presenza dell'oggetto SqlCeDataReader, è preferibile chiamare sempre il metodo Close prima della restituzione del valore della proprietà RecordsAffected per assicurare un valore restituito preciso.

Gerarchia di ereditarietà

System.Object
   System.MarshalByRefObject
     System.Data.Common.DbDataReader
      System.Data.SqlServerCe.SqlCeDataReader
         System.Data.SqlServerCe.SqlCeResultSet

Esempio

Nell'esempio che segue vengono creati un oggetto SqlCeConnection, un oggetto SqlCeCommand e un oggetto SqlCeDataReader. Nell'esempio che segue, i dati, dopo essere stati letti, vengono scritti sulla console e quindi vengono chiusi gli oggetti SqlCeDataReader e 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 Members
System.Data.SqlServerCe Namespace

Condividi tramite