SqlCeDataReader Class
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