SqlCeResultSet-Klasse

  • Artikel

Ein aktualisierbarer, bildlauffähiger und bindbarer Cursor.

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 SqlCeResultSet _
    Inherits SqlCeDataReader _
    Implements IEnumerable, IListSource
'Usage
Dim instance As SqlCeResultSet

public class SqlCeResultSet : SqlCeDataReader, 
    IEnumerable, IListSource

public ref class SqlCeResultSet : public SqlCeDataReader, 
    IEnumerable, IListSource

type SqlCeResultSet =  
    class
        inherit SqlCeDataReader
        interface IEnumerable
        interface IListSource
    end

public class SqlCeResultSet extends SqlCeDataReader implements IEnumerable, IListSource

Der SqlCeResultSet-Typ macht folgende Elemente verfügbar.

Konstruktoren

  Name Beschreibung
Geschützte Methode SqlCeResultSet Sicherheitskritisch Nicht verwenden. Die ExecuteResultSet(ResultSetOptions)-Methode von SqlCeCommand muss aufgerufen werden, um ein SqlCeResultSet zu erstellen.

Zum Anfang

Eigenschaften

  Name Beschreibung
Geschützte Eigenschaft ContainsListCollection Infrastruktur
Öffentliche Eigenschaft Depth Ruft einen Wert ab, der die Tiefe der Schachtelung für die aktuelle Zeile angibt. (von SqlCeDataReader vererbt)
Öffentliche Eigenschaft FieldCount Ruft die Anzahl der Spalten in der SELECT-Klausel der Abfrage ab. (von SqlCeDataReader vererbt)
Öffentliche Eigenschaft HasRows Ruft einen Wert ab, der angibt, ob der SqlCeDataReader eine oder mehrere Zeilen enthält. (von SqlCeDataReader vererbt)
Öffentliche Eigenschaft HiddenFieldCount Infrastruktur (von SqlCeDataReader vererbt)
Öffentliche Eigenschaft IsClosed Gibt an, ob der Datenreader geschlossen ist. (von SqlCeDataReader vererbt)
Öffentliche Eigenschaft Item[Int32] Fungiert als Indexer für das SqlCeResultSet. (Überschreibt SqlCeDataReader.Item[Int32].)
Öffentliche Eigenschaft Item[String] Fungiert als Indexer für das SqlCeResultSet. (Überschreibt SqlCeDataReader.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. (von SqlCeDataReader vererbt)
Öffentliche Eigenschaft ResultSetView Verwendet, wenn ein SqlCeResultSet über Datenbindung einem Steuerelement zugewiesen wird.
Öffentliche Eigenschaft Scrollable Bestimmt, ob das SqlCeResultSet bildlauffähig ist.
Öffentliche Eigenschaft Sensitivity Bestimmt die Sensitivität von SqlCeResultSet.
Öffentliche Eigenschaft Updatable Bestimmt, ob Werte innerhalb von SqlCeResultSet geändert werden können.
Öffentliche Eigenschaft VisibleFieldCount (von DbDataReader vererbt)

Zum Anfang

Methoden

  Name Beschreibung
Öffentliche Methode Close Schließt das SqlCeDataReader-Objekt. (von SqlCeDataReader vererbt)
Öffentliche Methode CreateObjRef (von MarshalByRefObject vererbt)
Öffentliche Methode CreateRecord Erstellt eine neue Zeile auf dem Server und gibt ein SqlCeUpdatableRecord-Objekt zurück.
Öffentliche Methode Delete Löscht den aktuellen Datensatz aus der Datenquelle auf dem Server.
Öffentliche Methode Dispose() Infrastruktur Gibt Ressourcen frei, die von dieser SqlCeDataReader-Klasse behandelt werden. (von SqlCeDataReader vererbt)
Geschützte Methode Dispose(Boolean) Gibt die von der SqlCeDataReader-Klasse verwendeten nicht verwalteten Ressourcen und optional auch die verwalteten Ressourcen frei. (von SqlCeDataReader vererbt)
Ö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. (von SqlCeDataReader vererbt)
Öffentliche Methode GetBoolean Gibt den Wert der Spalte am angegebenen Index als booleschen Wert zurück. (Überschreibt SqlCeDataReader.GetBoolean(Int32).)
Öffentliche Methode GetByte Gibt den Wert der Spalte am angegebenen Index als Byte zurück. (Überschreibt SqlCeDataReader.GetByte(Int32).)
Öffentliche Methode GetBytes Kopiert eine Bytelänge in den Puffer, beginnend bei einer angegebenen Position im angegebenen Feld. (Überschreibt SqlCeDataReader.GetBytes(Int32, Int64, array<Byte[], Int32, Int32).)
Öffentliche Methode GetChar Wird vom .NET Compact Framework-Datenanbieter für SQL Server Compact nicht unterstützt. (von SqlCeDataReader vererbt)
Öffentliche Methode GetChars Kopiert eine Zeichenlänge in den Puffer, beginnend bei einer angegebenen Position im angegebenen Feld. (Überschreibt SqlCeDataReader.GetChars(Int32, Int64, array<Char[], Int32, Int32).)
Öffentliche Methode GetData (von DbDataReader vererbt)
Öffentliche Methode GetDataTypeName Ruft den Namen des Quelldatentyps ab. (von SqlCeDataReader vererbt)
Öffentliche Methode GetDateTime Gibt den Wert der Spalte am angegebenen Index als Wert des Typs DateTime zurück. (Überschreibt SqlCeDataReader.GetDateTime(Int32).)
Geschützte Methode GetDbDataReader (von DbDataReader vererbt)
Öffentliche Methode GetDecimal Gibt den Wert der Spalte am angegebenen Index als Wert des Typs Double zurück. (Überschreibt SqlCeDataReader.GetDecimal(Int32).)
Öffentliche Methode GetDouble Gibt den Wert der Spalte am angegebenen Index als Wert des Typs Double zurück. (Überschreibt SqlCeDataReader.GetDouble(Int32).)
Öffentliche Methode GetEnumerator Gibt einen IEnumerator zurück, mit dem die Zeilen im Datenreader durchlaufen werden können. (Überschreibt SqlCeDataReader.GetEnumerator().)
Öffentliche Methode GetFieldType Ruft den Type ab, der den Datentyp des Objekts darstellt. (von SqlCeDataReader vererbt)
Öffentliche Methode GetFloat Gibt den Wert der Spalte am angegebenen Index als Wert des Typs Float zurück. (Überschreibt SqlCeDataReader.GetFloat(Int32).)
Öffentliche Methode GetGuid Gibt den Wert der Spalte am angegebenen Index als Wert des Typs GUID zurück. (Überschreibt SqlCeDataReader.GetGuid(Int32).)
Öffentliche Methode GetHashCode (von Object vererbt)
Öffentliche Methode GetInt16 Gibt den Wert der Spalte am angegebenen Index als Wert des Typs Int16 zurück. (Überschreibt SqlCeDataReader.GetInt16(Int32).)
Öffentliche Methode GetInt32 Gibt den Wert der Spalte am angegebenen Index als Wert des Typs Int32 zurück. (Überschreibt SqlCeDataReader.GetInt32(Int32).)
Öffentliche Methode GetInt64 Gibt den Wert der Spalte am angegebenen Index als Wert des Typs Int64 zurück. (Überschreibt SqlCeDataReader.GetInt64(Int32).)
Öffentliche Methode GetLifetimeService (von MarshalByRefObject vererbt)
Geschützte Methode GetList Gibt eine Instanz von ResultSetView zurück.
Öffentliche Methode GetName Ruft den Namen der angegebenen Spalte ab. (von SqlCeDataReader vererbt)
Öffentliche Methode GetOrdinal Ruft bei angegebenem Spaltennamen die Ordnungszahl der Spalte ab. (von SqlCeDataReader vererbt)
Öffentliche Methode GetProviderSpecificFieldType Ruft ein Object ab, das eine Darstellung des Feldtyps ist, der für den zugrunde liegenden Anbieter spezifisch ist. (von SqlCeDataReader vererbt)
Ö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. (von SqlCeDataReader vererbt)
Öffentliche Methode GetSqlBinary Gibt den Wert der Spalte am angegebenen Index als Wert des Typs SqlBinary zurück. (Überschreibt SqlCeDataReader.GetSqlBinary(Int32).)
Öffentliche Methode GetSqlBoolean Gibt den Wert der Spalte am angegebenen Index als Wert des Typs SqlBoolean zurück. (Überschreibt SqlCeDataReader.GetSqlBoolean(Int32).)
Öffentliche Methode GetSqlByte Gibt den Wert der Spalte am angegebenen Index als Wert des Typs SqlByte zurück. (Überschreibt SqlCeDataReader.GetSqlByte(Int32).)
Öffentliche Methode GetSqlDateTime Gibt den Wert der Spalte am angegebenen Index als Wert des Typs SqlDateTime zurück. (Überschreibt SqlCeDataReader.GetSqlDateTime(Int32).)
Öffentliche Methode GetSqlDecimal Gibt den Wert der Spalte am angegebenen Index als Wert des Typs SqlDecimal zurück. (Überschreibt SqlCeDataReader.GetSqlDecimal(Int32).)
Öffentliche Methode GetSqlDouble Gibt den Wert der Spalte am angegebenen Index als Wert des Typs SqlDouble zurück. (Überschreibt SqlCeDataReader.GetSqlDouble(Int32).)
Öffentliche Methode GetSqlGuid Gibt den Wert der Spalte am angegebenen Index als Wert des Typs SqlGuid zurück. (Überschreibt SqlCeDataReader.GetSqlGuid(Int32).)
Öffentliche Methode GetSqlInt16 Gibt den Wert der Spalte am angegebenen Index als Wert des Typs SqlInt16 zurück. (Überschreibt SqlCeDataReader.GetSqlInt16(Int32).)
Öffentliche Methode GetSqlInt32 Gibt den Wert der Spalte am angegebenen Index als Wert des Typs SqlInt32 zurück. (Überschreibt SqlCeDataReader.GetSqlInt32(Int32).)
Öffentliche Methode GetSqlInt64 Gibt den Wert der Spalte am angegebenen Index als Wert des Typs SqlInt64 zurück. (Überschreibt SqlCeDataReader.GetSqlInt64(Int32).)
Öffentliche Methode GetSqlMetaData Gibt die der angegebenen Spalte zugeordneten Metadaten-Informationen zurück.
Öffentliche Methode GetSqlMoney Gibt den Wert der Spalte am angegebenen Index als Wert des Typs SqlMoney zurück. (Überschreibt SqlCeDataReader.GetSqlMoney(Int32).)
Öffentliche Methode GetSqlSingle Gibt den Wert der Spalte am angegebenen Index als Wert des Typs SqlSingle zurück. (Überschreibt SqlCeDataReader.GetSqlSingle(Int32).)
Öffentliche Methode GetSqlString Gibt den Wert der Spalte am angegebenen Index als Wert des Typs SqlString zurück. (Überschreibt SqlCeDataReader.GetSqlString(Int32).)
Öffentliche Methode GetString Gibt den Wert der Spalte am angegebenen Index als Wert des Typs String zurück. (Überschreibt SqlCeDataReader.GetString(Int32).)
Öffentliche Methode GetType (von Object vererbt)
Öffentliche Methode GetValue Gibt den Wert des angegebenen Felds zurück. (Überschreibt SqlCeDataReader.GetValue(Int32).)
Öffentliche Methode GetValues Ruft ein Array aller Felder für den angegebenen Datensatz ab. (Überschreibt SqlCeDataReader.GetValues(array<Object[]).)
Öffentliche Methode InitializeLifetimeService (von MarshalByRefObject vererbt)
Öffentliche Methode Insert(SqlCeUpdatableRecord) Fügt den angegebenen SqlCeUpdatableRecord in das zugrunde liegende Rowset ein.
Öffentliche Methode Insert(SqlCeUpdatableRecord, DbInsertOptions) Fügt den angegebenen SqlCeUpdatableRecord in das zugrunde liegende Rowset ein und gibt an, wie der Cursor positioniert wird.
Geschützte Methode IsCommandBehavior Gibt an, ob das angegebene CommandBehavior-Element mit diesem SqlCeDataReader-Element übereinstimmt. (von SqlCeDataReader vererbt)
Öffentliche Methode IsDBNull Bestimmt, ob das Feld an der angegebenen Ordinalposition NULL ist. (Überschreibt SqlCeDataReader.IsDBNull(Int32).)
Öffentliche Methode IsSetAsDefault Bestimmt, ob das Feld an der angegebenen Ordinalposition so markiert ist, dass es den zugrunde liegenden Standardwert verwendet.
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. (von SqlCeDataReader vererbt)
Geschützte Methode OnMove Infrastruktur (Überschreibt SqlCeDataReader.OnMove().)
Öffentliche Methode Read Setzt die SqlCeDataReader-Klasse auf den nächsten Datensatz. (von SqlCeDataReader vererbt)
Öffentliche Methode ReadAbsolute Verschiebt den Reader zu einem bestimmten Datensatz im ResultSet.
Öffentliche Methode ReadFirst Positioniert den Reader am ersten Datensatz im ResultSet.
Öffentliche Methode ReadLast Positioniert den Reader am letzten Datensatz im ResultSet.
Öffentliche Methode ReadPrevious Positioniert den Reader am Datensatz vor dem aktuellen Datensatz.
Öffentliche Methode ReadRelative Verschiebt den Reader von der aktuellen Position ausgehend um die angegebene Anzahl.
Öffentliche Methode Seek Platziert die SqlCeDataReader-Klasse im Datensatz mit indizierten Werten, die den angegebenen Parametern entsprechen. (von SqlCeDataReader vererbt)
Öffentliche Methode SetBoolean Legt den Wert der angegebenen Spalte auf den übergebenen booleschen Wert fest.
Öffentliche Methode SetByte Legt den Wert der angegebenen Spalte auf den übergebenen Byte-Wert fest.
Öffentliche Methode SetBytes Kopiert eine Bytelänge vom angegebenen Puffer in die angegebene Spalte, beginnend bei der angegebenen Position innerhalb dieses Felds.
Öffentliche Methode SetChar Legt den Wert der angegebenen Spalte auf den übergebenen Char-Wert fest.
Öffentliche Methode SetChars Kopiert eine Zeichenlänge vom angegebenen Puffer in die angegebene Spalte, beginnend bei der angegebenen Position innerhalb dieses Felds.
Öffentliche Methode SetDateTime Legt den Wert der angegebenen Spalte auf den übergebenen DateTime-Wert fest.
Öffentliche Methode SetDecimal Legt den Wert der angegebenen Spalte auf den übergebenen Decimal-Wert fest.
Öffentliche Methode SetDefault Legt die angegebene Spalte auf den Standardwert fest.
Öffentliche Methode SetDouble Legt den Wert der angegebenen Spalte auf den übergebenen Double-Wert fest.
Öffentliche Methode SetFloat Legt den Wert der angegebenen Spalte auf den übergebenen Float-Wert fest.
Öffentliche Methode SetGuid Legt den Wert der angegebenen Spalte auf den übergebenen GUID-Wert fest.
Öffentliche Methode SetInt16 Legt den Wert der angegebenen Spalte auf den übergebenen Int16-Wert fest.
Öffentliche Methode SetInt32 Legt den Wert der angegebenen Spalte auf den übergebenen Int32-Wert fest.
Öffentliche Methode SetInt64 Legt den Wert der angegebenen Spalte auf den übergebenen Int64-Wert fest.
Öffentliche Methode SetObjectRef Bindet ein Objekt an der angegebenen Position an die Spalte.
Öffentliche Methode SetSqlBinary Legt den Wert der angegebenen Spalte auf den übergebenen SqlBinary-Wert fest.
Öffentliche Methode SetSqlBoolean Legt den Wert der angegebenen Spalte auf den übergebenen SqlBoolean-Wert fest.
Öffentliche Methode SetSqlByte Legt den Wert der angegebenen Spalte auf den übergebenen SqlByte-Wert fest.
Öffentliche Methode SetSqlDateTime Legt den Wert der angegebenen Spalte auf den übergebenen SqlDateTime-Wert fest.
Öffentliche Methode SetSqlDecimal Legt den Wert der angegebenen Spalte auf den übergebenen SqlDecimal-Wert fest.
Öffentliche Methode SetSqlDouble Legt den Wert der angegebenen Spalte auf den übergebenen SqlDouble-Wert fest.
Öffentliche Methode SetSqlGuid Legt den Wert der angegebenen Spalte auf den übergebenen SqlGuid-Wert fest.
Öffentliche Methode SetSqlInt16 Legt den Wert der angegebenen Spalte auf den übergebenen SqlInt16-Wert fest.
Öffentliche Methode SetSqlInt32 Legt den Wert der angegebenen Spalte auf den übergebenen SqlInt32-Wert fest.
Öffentliche Methode SetSqlInt64 Legt den Wert der angegebenen Spalte auf den übergebenen SqlInt64-Wert fest.
Öffentliche Methode SetSqlMoney Legt den Wert der angegebenen Spalte auf den übergebenen SqlMoney-Wert fest.
Öffentliche Methode SetSqlSingle Legt den Wert der angegebenen Spalte auf den übergebenen SqlSingle-Wert fest.
Öffentliche Methode SetSqlString Legt den Wert der angegebenen Spalte auf den übergebenen SqlString-Wert fest.
Öffentliche Methode SetString Legt den Wert der angegebenen Spalte auf den übergebenen String-Wert fest.
Öffentliche Methode SetValue Legt den Wert der angegebenen Spalte auf den übergebenen Wert fest.
Öffentliche Methode SetValues Legt die einzelnen Felder im angegebenen Datensatz auf den entsprechenden Wert im angegebenen Array fest.
Öffentliche Methode ToString (von Object vererbt)
Öffentliche Methode Update Sendet Änderungen vom aktuellen Datensatz an die zugrunde liegende Zeile auf dem Server.

Zum Anfang

Explizite Schnittstellenimplementierungen

  Name Beschreibung
Explizite SchnittstellenimplementierungPrivate Eigenschaft IListSource.ContainsListCollection
Explizite SchnittstellenimplementierungPrivate Methode IEnumerable.GetEnumerator
Explizite SchnittstellenimplementierungPrivate Methode IListSource.GetList
Explizite SchnittstellenimplementierungPrivate Methode IDataRecord.GetData (von DbDataReader vererbt)

Zum Anfang

Hinweise

In früheren Versionen von SQL Server Compact mussten Steuerelemente mithilfe eines DataSet an Daten gebunden werden. Zwar stellt ein SqlCeDataReader eine bessere Leistung bereit als ein DataSet, doch ist er ein nicht aktualisierbarer, vorwärts gerichteter Cursor. In SQL Server Compact bietet das SqlCeResultSet eine Kombination mehrerer Funktionen: die Aktualisierbarkeit und die Bildlauffähigkeit des DataSet sowie eine ähnliche Leistung wie der SqlCeDataReader.

Anstelle der direkten Verwendung eines Konstruktors müssen Sie zum Erstellen von SqlCeResultSet statt des Konstruktors des Objekts die ExecuteResultSet-Methode aufrufen.

Mithilfe von ResultSetOptions kann die Bildlauffähigkeit, die Aktualisierbarkeit und die Sensitivität von SqlCeResultSet angegeben werden (wodurch bestimmt wird, ob Änderungen durch diese oder andere Klassen vom SqlCeResultSet gefunden werden).

Die Standardposition der SqlCeDataReader-Klasse ist vor dem ersten Datensatz. Daher müssen Sie "Read" aufrufen, um auf Daten zugreifen zu können. Das erste "Read" positioniert den Cursor am ersten Datensatz. Das Verhalten ist anders als bei der "SqlCeResultSet.Read"-Methode. Die Standardposition von "SqlCeResultSet" ist vor dem ersten Datensatz. Durch Aufrufen der "SqlCeResultSet.Read"-Methode sofort nach Erstellen von "SqlCeResultSet" wird der Cursor auf den zweiten Datensatz verschoben.

Beispiele

Im folgenden Beispiel wird eine neue SQL Server Compact-Datenbank erstellt. Dann wird ein SqlCeResultSet initialisiert, um das Dataset mit Daten zu füllen.

Dim conn As SqlCeConnection = Nothing

Try
    File.Delete("Test.sdf")

    Dim engine As New SqlCeEngine("Data Source = Test.sdf")
    engine.CreateDatabase()

    conn = New SqlCeConnection("Data Source = Test.sdf")
    conn.Open()

    Dim cmd As SqlCeCommand = conn.CreateCommand()
    cmd.CommandText = "CREATE TABLE myTable (col1 INT, col2 MONEY, col3 NVARCHAR(200))"
    cmd.ExecuteNonQuery()

    cmd.CommandText = "SELECT * FROM myTable"

    Dim rs As SqlCeResultSet = cmd.ExecuteResultSet(ResultSetOptions.Updatable Or ResultSetOptions.Scrollable)

    Dim rec As SqlCeUpdatableRecord = rs.CreateRecord()

    rec.SetInt32(0, 34)
    rec.SetDecimal(1, System.Convert.ToDecimal(44.66))
    rec.SetString(2, "Sample text")

    rs.Insert(rec)
Catch e As Exception
    MessageBox.Show(e.Message)
Finally
    conn.Close()
End Try

SqlCeConnection conn = null;

try
{
    File.Delete("Test.sdf");

    SqlCeEngine engine = new SqlCeEngine("Data Source = Test.sdf");
    engine.CreateDatabase();

    conn = new SqlCeConnection("Data Source = Test.sdf");
    conn.Open();

    SqlCeCommand cmd = conn.CreateCommand();
    cmd.CommandText = "CREATE TABLE myTable (col1 INT, col2 MONEY, col3 NVARCHAR(200))";
    cmd.ExecuteNonQuery();

    cmd.CommandText = "SELECT * FROM myTable";

    SqlCeResultSet rs = cmd.ExecuteResultSet(ResultSetOptions.Updatable | 
        ResultSetOptions.Scrollable);

    SqlCeUpdatableRecord rec = rs.CreateRecord();

    rec.SetInt32(0, 34);
    rec.SetDecimal(1, (decimal)44.66);
    rec.SetString(2, "Sample text");

    rs.Insert(rec);
}
catch (Exception e)
{
    MessageBox.Show(e.Message);
}
finally
{
    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