SqlCeDataReader-Klasse
Bietet ein Verfahren für das Lesen eines Vorwärtsstreams von Datenzeilen aus einer Datenquelle. Die Klasse kann nicht vererbt werden.
Namespace: System.Data.SqlServerCe
Assembly: System.Data.SqlServerCe (in system.data.sqlserverce.dll)
Syntax
'Declaration
Public Class SqlCeDataReader
Inherits DbDataReader
'Usage
Dim instance As SqlCeDataReader
public class SqlCeDataReader : DbDataReader
public ref class SqlCeDataReader : public DbDataReader
public class SqlCeDataReader extends DbDataReader
public class SqlCeDataReader extends DbDataReader
Hinweise
Anstelle der direkten Verwendung eines Konstruktors müssen Sie zum Erstellen einer SqlCeDataReader-Klasse die ExecuteReader-Methode des SqlCeCommand-Objekts aufrufen.
Während die SqlCeDataReader-Klasse verwendet wird, ist die zugeordnete SqlCeConnection-Klasse durch den Informationsfluss für die SqlCeDataReader-Klasse belegt. In diesem Zustand können Sie mehrere Reader in derselben Verbindung erstellen.
Änderungen an einem Ergebnis, die durch einen anderen Prozess oder Thread festgelegt werden, während die Daten gelesen werden, können dem Benutzer der SqlCeDataReader-Klasse angezeigt werden, doch hängt das genaue Verhalten davon ab, wann die Änderungen auftreten.
Die IsClosed-Eigenschaft und die RecordsAffected-Eigenschaft sind die einzigen Eigenschaften, die Sie nach dem Schließen der SqlCeDataReader-Klasse aufrufen können. Obwohl jederzeit auf die RecordsAffected-Eigenschaft zugegriffen werden kann, solange die SqlCeDataReader-Klasse vorhanden ist, sollten Sie immer zuerst Close aufrufen, bevor der Wert von RecordsAffected zurückgegeben wird, um einen korrekten Rückgabewert zu erhalten.
Beispiel
Im folgenden Beispiel werden die Klassen SqlCeConnection, SqlCeCommand und SqlCeDataReader erstellt. In diesem Beispiel werden die Daten durchgelesen und in die Konsole geschrieben. Danach werden die SqlCeDataReader-Klasse und die SqlCeConnection-Klasse geschlossen.
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();
}
Vererbungshierarchie
System.Object
System.MarshalByRefObject
System.Data.Common.DbDataReader
System.Data.SqlServerCe.SqlCeDataReader
System.Data.SqlServerCe.SqlCeResultSet
Threadsicherheit
Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.
Plattformen
Windows CE, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows XP Professional x64 Edition, Windows XP SP2
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Compact Framework
Unterstützt in: 2.0, 1.0