SqlCeDataReader-Klasse

  • Artikel

Bietet ein Verfahren für das Lesen eines Vorwärtsdatenstroms von Datenzeilen aus einer Datenquelle. Diese Klasse kann nicht vererbt werden.

Vererbungshierarchie

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

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

type SqlCeDataReader =  
    class
        inherit DbDataReader
    end

public class SqlCeDataReader extends DbDataReader

Der SqlCeDataReader-Typ macht folgende Elemente verfügbar.

Eigenschaften

  Name Beschreibung
Öffentliche Eigenschaft Depth Ruft einen Wert ab, der die Tiefe der Schachtelung für die aktuelle Zeile angibt. (Überschreibt DbDataReader.Depth.)
Öffentliche Eigenschaft FieldCount Ruft die Anzahl der Spalten in der SELECT-Klausel der Abfrage ab. (Überschreibt DbDataReader.FieldCount.)
Öffentliche Eigenschaft HasRows Ruft einen Wert ab, der angibt, ob der SqlCeDataReader eine oder mehrere Zeilen enthält. (Überschreibt DbDataReader.HasRows.)
Öffentliche Eigenschaft HiddenFieldCount Infrastruktur
Öffentliche Eigenschaft IsClosed Gibt an, ob der Datenreader geschlossen ist. (Überschreibt DbDataReader.IsClosed.)
Öffentliche Eigenschaft Item[Int32] Ruft bei angegebener Spaltenordnungszahl den Wert der angegebenen Spalte im systemeigenen Format ab. (Überschreibt DbDataReader.Item[Int32].)
Öffentliche Eigenschaft Item[String] Ruft bei angegebenem Spaltennamen den Wert der angegebenen Spalte im systemeigenen Format ab. (Überschreibt DbDataReader.Item[String].)
Öffentliche Eigenschaft RecordsAffected Ruft die Anzahl der durch die Ausführung der SQL-Anweisung geänderten, eingefügten oder gelöschten Zeilen ab. (Überschreibt DbDataReader.RecordsAffected.)
Öffentliche Eigenschaft VisibleFieldCount (von DbDataReader vererbt)

Zum Anfang

Methoden

  Name Beschreibung
Öffentliche Methode Close Schließt das SqlCeDataReader-Objekt. (Überschreibt DbDataReader.Close().)
Öffentliche Methode CreateObjRef (von MarshalByRefObject vererbt)
Öffentliche Methode Dispose() Infrastruktur Gibt Ressourcen frei, die von dieser SqlCeDataReader-Klasse behandelt werden.
Geschützte Methode Dispose(Boolean) Gibt die von der SqlCeDataReader-Klasse verwendeten nicht verwalteten Ressourcen und optional auch die verwalteten Ressourcen frei. (Überschreibt DbDataReader.Dispose(Boolean).)
Öffentliche Methode Equals (von Object vererbt)
Geschützte Methode Finalize Gibt nicht verwaltete Ressourcen frei und führt andere Bereinigungsvorgänge durch, bevor der SqlCeDataReader durch die Garbage Collection wieder zugänglich gemacht wird. (Überschreibt Object.Finalize().)
Öffentliche Methode GetBoolean Ruft den Wert der angegebenen Spalte als booleschen Wert ab. (Überschreibt DbDataReader.GetBoolean(Int32).)
Öffentliche Methode GetByte Ruft den Wert der angegebenen Spalte als Byte ab. (Überschreibt DbDataReader.GetByte(Int32).)
Öffentliche Methode GetBytes Liest beginnend am angegebenen Pufferoffset einen Datenstrom von Bytes aus dem angegebenen Spaltenoffset als Array in den Puffer. (Überschreibt DbDataReader.GetBytes(Int32, Int64, array<Byte[], Int32, Int32).)
Öffentliche Methode GetChar Wird vom .NET Compact Framework-Datenanbieter für SQL Server Compact nicht unterstützt. (Überschreibt DbDataReader.GetChar(Int32).)
Öffentliche Methode GetChars Liest beginnend am angegebenen Pufferoffset einen Datenstrom von Zeichen aus dem angegebenen Spaltenoffset in den Puffer eines Arrays. (Überschreibt DbDataReader.GetChars(Int32, Int64, array<Char[], Int32, Int32).)
Öffentliche Methode GetData (von DbDataReader vererbt)
Öffentliche Methode GetDataTypeName Ruft den Namen des Quelldatentyps ab. (Überschreibt DbDataReader.GetDataTypeName(Int32).)
Öffentliche Methode GetDateTime Ruft den Wert der angegebenen Spalte als DateTime-Objekt ab. (Überschreibt DbDataReader.GetDateTime(Int32).)
Geschützte Methode GetDbDataReader (von DbDataReader vererbt)
Öffentliche Methode GetDecimal Ruft den Wert der angegebenen Spalte als Decimal-Objekt ab. (Überschreibt DbDataReader.GetDecimal(Int32).)
Öffentliche Methode GetDouble Ruft den Wert der angegebenen Spalte als Gleitkommazahl mit doppelter Genauigkeit ab. (Überschreibt DbDataReader.GetDouble(Int32).)
Öffentliche Methode GetEnumerator Infrastruktur (Überschreibt DbDataReader.GetEnumerator().)
Öffentliche Methode GetFieldType Ruft den Type ab, der den Datentyp des Objekts darstellt. (Überschreibt DbDataReader.GetFieldType(Int32).)
Öffentliche Methode GetFloat Ruft den Wert der angegebenen Spalte als Gleitkommazahl mit einfacher Genauigkeit ab. (Überschreibt DbDataReader.GetFloat(Int32).)
Öffentliche Methode GetGuid Ruft den Wert der angegebenen Spalte als global eindeutigen Bezeichner (Globally Unique Identifier, GUID) ab. (Überschreibt DbDataReader.GetGuid(Int32).)
Öffentliche Methode GetHashCode (von Object vererbt)
Öffentliche Methode GetInt16 Ruft den Wert der angegebenen Spalte als 16-Bit-Ganzzahl mit Vorzeichen ab. (Überschreibt DbDataReader.GetInt16(Int32).)
Öffentliche Methode GetInt32 Ruft den Wert der angegebenen Spalte als 32-Bit-Ganzzahl mit Vorzeichen ab. (Überschreibt DbDataReader.GetInt32(Int32).)
Öffentliche Methode GetInt64 Ruft den Wert der angegebenen Spalte als 64-Bit-Ganzzahl mit Vorzeichen ab. (Überschreibt DbDataReader.GetInt64(Int32).)
Öffentliche Methode GetLifetimeService (von MarshalByRefObject vererbt)
Öffentliche Methode GetName Ruft den Namen der angegebenen Spalte ab. (Überschreibt DbDataReader.GetName(Int32).)
Öffentliche Methode GetOrdinal Ruft bei angegebenem Spaltennamen die Ordnungszahl der Spalte ab. (Überschreibt DbDataReader.GetOrdinal(String).)
Öffentliche Methode GetProviderSpecificFieldType Ruft ein Object ab, das eine Darstellung des Feldtyps ist, der für den zugrunde liegenden Anbieter spezifisch ist. (Überschreibt DbDataReader.GetProviderSpecificFieldType(Int32).)
Öffentliche Methode GetProviderSpecificValue (von DbDataReader vererbt)
Öffentliche Methode GetProviderSpecificValues (von DbDataReader vererbt)
Öffentliche Methode GetSchemaTable Gibt eine DataTable-Klasse zurück, die die Spaltenmetadaten der SqlCeDataReader-Klasse beschreibt. (Überschreibt DbDataReader.GetSchemaTable().)
Öffentliche Methode GetSqlBinary Ruft den Wert der angegebenen Spalte als SqlBinary ab.
Öffentliche Methode GetSqlBoolean Ruft den Wert der angegebenen Spalte als SqlBoolean ab.
Öffentliche Methode GetSqlByte Ruft den Wert der angegebenen Spalte als SqlByte ab.
Öffentliche Methode GetSqlDateTime Ruft den Wert der angegebenen Spalte als SqlDateTime ab.
Öffentliche Methode GetSqlDecimal Ruft den Wert der angegebenen Spalte als SqlDecimal ab.
Öffentliche Methode GetSqlDouble Ruft den Wert der angegebenen Spalte als SqlDouble ab.
Öffentliche Methode GetSqlGuid Ruft den Wert der angegebenen Spalte als SqlGuid ab.
Öffentliche Methode GetSqlInt16 Ruft den Wert der angegebenen Spalte als SqlInt16 ab.
Öffentliche Methode GetSqlInt32 Ruft den Wert der angegebenen Spalte als SqlInt32 ab.
Öffentliche Methode GetSqlInt64 Ruft den Wert der angegebenen Spalte als SqlInt64 ab.
Öffentliche Methode GetSqlMoney Ruft den Wert der angegebenen Spalte als SqlMoney ab.
Öffentliche Methode GetSqlSingle Ruft den Wert der angegebenen Spalte als SqlSingle ab.
Öffentliche Methode GetSqlString Ruft den Wert der angegebenen Spalte als SqlString ab.
Öffentliche Methode GetString Ruft den Wert der angegebenen Spalte als eine Zeichenfolge ab. (Überschreibt DbDataReader.GetString(Int32).)
Öffentliche Methode GetType (von Object vererbt)
Öffentliche Methode GetValue Ruft den Wert der Spalte an der angegebenen Ordnungszahl im systemeigenen Format ab. (Überschreibt DbDataReader.GetValue(Int32).)
Öffentliche Methode GetValues Ruft alle Attributspalten in der aktuellen Zeile ab. (Überschreibt DbDataReader.GetValues(array<Object[]).)
Öffentliche Methode InitializeLifetimeService (von MarshalByRefObject vererbt)
Geschützte Methode IsCommandBehavior Gibt an, ob das angegebene CommandBehavior-Element mit diesem SqlCeDataReader-Element übereinstimmt.
Öffentliche Methode IsDBNull Ruft einen Wert ab, der angibt, ob die Spalte nicht vorhandene oder fehlende Werte enthält. (Überschreibt DbDataReader.IsDBNull(Int32).)
Geschützte Methode MemberwiseClone() (von Object vererbt)
Geschützte Methode MemberwiseClone(Boolean) (von MarshalByRefObject vererbt)
Öffentliche Methode NextResult Wird vom .NET Compact Framework-Datenanbieter für SQL Server Compact nicht unterstützt. (Überschreibt DbDataReader.NextResult().)
Geschützte Methode OnMove Infrastruktur
Öffentliche Methode Read Setzt die SqlCeDataReader-Klasse auf den nächsten Datensatz. (Überschreibt DbDataReader.Read().)
Öffentliche Methode Seek Platziert die SqlCeDataReader-Klasse im Datensatz mit indizierten Werten, die den angegebenen Parametern entsprechen.
Öffentliche Methode ToString (von Object vererbt)

Zum Anfang

Explizite Schnittstellenimplementierungen

  Name Beschreibung
Explizite SchnittstellenimplementierungPrivate Methode IDataRecord.GetData (von DbDataReader vererbt)

Zum Anfang

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.

Beispiele

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

Threadsicherheit

Alle öffentlichen statischen (in Microsoft Visual Basic freigegebenen) Elemente dieses Typs sind threadsicher. Für Instanzelemente kann nicht sichergestellt werden, dass sie threadsicher sind.

Siehe auch

Verweis

System.Data.SqlServerCe-Namespace