SqlCeDataAdapter-Klasse

  • Artikel

Stellt einen Satz von Datenbefehlen und eine Datenbankverbindung dar, die zum Füllen des DataSet und zum Aktualisieren der Datenquelle verwendet werden.

Vererbungshierarchie

System.Object
  System.MarshalByRefObject
    System.ComponentModel.Component
      System.Data.Common.DataAdapter
        System.Data.Common.DbDataAdapter
          System.Data.SqlServerCe.SqlCeDataAdapter

Namespace:  System.Data.SqlServerCe
Assembly:  System.Data.SqlServerCe (in System.Data.SqlServerCe.dll)

Syntax

'Declaration
Public NotInheritable Class SqlCeDataAdapter _
    Inherits DbDataAdapter _
    Implements ICloneable
'Usage
Dim instance As SqlCeDataAdapter

public sealed class SqlCeDataAdapter : DbDataAdapter, 
    ICloneable

public ref class SqlCeDataAdapter sealed : public DbDataAdapter, 
    ICloneable

[<SealedAttribute>]
type SqlCeDataAdapter =  
    class
        inherit DbDataAdapter
        interface ICloneable
    end

public final class SqlCeDataAdapter extends DbDataAdapter implements ICloneable

Der SqlCeDataAdapter-Typ macht folgende Elemente verfügbar.

Konstruktoren

  Name Beschreibung
Öffentliche Methode SqlCeDataAdapter() Initialisiert eine neue Instanz der SqlCeDataAdapter-Klasse.
Öffentliche Methode SqlCeDataAdapter(SqlCeCommand) Initialisiert eine neue Instanz der SqlCeDataAdapter-Klasse mit des angegebenen SqlCeCommand als SelectCommand-Eigenschaft.
Öffentliche Methode SqlCeDataAdapter(String, SqlCeConnection) Initialisiert eine neue Instanz der SqlCeDataAdapter-Klasse mit einem SelectCommand und einem SqlCeConnection-Objekt.
Öffentliche Methode SqlCeDataAdapter(String, String) Initialisiert eine neue Instanz der SqlCeDataAdapter-Klasse mit einem SelectCommand und einer Verbindungszeichenfolge.

Zum Anfang

Eigenschaften

  Name Beschreibung
Öffentliche Eigenschaft AcceptChangesDuringFill (von DataAdapter vererbt)
Öffentliche Eigenschaft AcceptChangesDuringUpdate (von DataAdapter vererbt)
Geschützte Eigenschaft CanRaiseEvents (von Component vererbt)
Öffentliche Eigenschaft Container (von Component vererbt)
Öffentliche Eigenschaft ContinueUpdateOnError (von DataAdapter vererbt)
Öffentliche Eigenschaft DeleteCommand Ruft eine SQL-Anweisung zum Löschen von Datensätzen aus dem Dataset ab oder legt diese fest.
Geschützte Eigenschaft DesignMode (von Component vererbt)
Geschützte Eigenschaft Events (von Component vererbt)
Geschützte Eigenschaft FillCommandBehavior (von DbDataAdapter vererbt)
Öffentliche Eigenschaft FillLoadOption (von DataAdapter vererbt)
Öffentliche Eigenschaft InsertCommand Ruft eine SQL-Anweisung ab, mit der neue Datensätze in die Datenquelle eingefügt werden, oder legt diese fest.
Öffentliche Eigenschaft MissingMappingAction (von DataAdapter vererbt)
Öffentliche Eigenschaft MissingSchemaAction (von DataAdapter vererbt)
Öffentliche Eigenschaft ReturnProviderSpecificTypes (von DataAdapter vererbt)
Öffentliche Eigenschaft SelectCommand Ruft eine SQL-Anweisung ab, mit der Datensätze in der Datenquelle ausgewählt werden, oder legt diese fest.
Öffentliche Eigenschaft Site (von Component vererbt)
Öffentliche Eigenschaft TableMappings (von DataAdapter vererbt)
Öffentliche Eigenschaft UpdateBatchSize (von DbDataAdapter vererbt)
Öffentliche Eigenschaft UpdateCommand Ruft eine SQL-Anweisung ab, mit der Datensätze in der Datenquelle aktualisiert werden, oder legt diese fest.

Zum Anfang

Methoden

  Name Beschreibung
Geschützte Methode AddToBatch (von DbDataAdapter vererbt)
Geschützte Methode ClearBatch (von DbDataAdapter vererbt)
Geschützte Methode CloneInternals Veraltet (von DataAdapter vererbt)
Öffentliche Methode CreateObjRef (von MarshalByRefObject vererbt)
Geschützte Methode CreateRowUpdatedEvent (von DbDataAdapter vererbt)
Geschützte Methode CreateRowUpdatingEvent (von DbDataAdapter vererbt)
Geschützte Methode CreateTableMappings (von DataAdapter vererbt)
Öffentliche Methode Dispose() Verwirft die aktuelle Instanz.
Geschützte Methode Dispose(Boolean) (von DbDataAdapter vererbt)
Öffentliche Methode Equals (von Object vererbt)
Geschützte Methode ExecuteBatch (von DbDataAdapter vererbt)
Öffentliche Methode Fill(DataSet) (von DbDataAdapter vererbt)
Öffentliche Methode Fill(DataTable) (von DbDataAdapter vererbt)
Öffentliche Methode Fill(DataSet, String) (von DbDataAdapter vererbt)
Geschützte Methode Fill(DataTable, IDataReader) (von DataAdapter vererbt)
Öffentliche Methode Fill(Int32, Int32, array<DataTable[]) (von DbDataAdapter vererbt)
Geschützte Methode Fill(DataTable, IDbCommand, CommandBehavior) (von DbDataAdapter vererbt)
Öffentliche Methode Fill(DataSet, Int32, Int32, String) (von DbDataAdapter vererbt)
Geschützte Methode Fill(array<DataTable[], IDataReader, Int32, Int32) (von DataAdapter vererbt)
Geschützte Methode Fill(array<DataTable[], Int32, Int32, IDbCommand, CommandBehavior) (von DbDataAdapter vererbt)
Geschützte Methode Fill(DataSet, String, IDataReader, Int32, Int32) (von DataAdapter vererbt)
Geschützte Methode Fill(DataSet, Int32, Int32, String, IDbCommand, CommandBehavior) (von DbDataAdapter vererbt)
Öffentliche Methode FillSchema(DataTable, SchemaType) (von DbDataAdapter vererbt)
Öffentliche Methode FillSchema(DataSet, SchemaType) (von DbDataAdapter vererbt)
Öffentliche Methode FillSchema(DataSet, SchemaType, String) (von DbDataAdapter vererbt)
Geschützte Methode FillSchema(DataTable, SchemaType, IDataReader) (von DataAdapter vererbt)
Geschützte Methode FillSchema(DataTable, SchemaType, IDbCommand, CommandBehavior) (von DbDataAdapter vererbt)
Geschützte Methode FillSchema(DataSet, SchemaType, String, IDataReader) (von DataAdapter vererbt)
Geschützte Methode FillSchema(DataSet, SchemaType, IDbCommand, String, CommandBehavior) (von DbDataAdapter vererbt)
Geschützte Methode Finalize (von Component vererbt)
Geschützte Methode GetBatchedParameter (von DbDataAdapter vererbt)
Geschützte Methode GetBatchedRecordsAffected (von DbDataAdapter vererbt)
Öffentliche Methode GetFillParameters (von DbDataAdapter vererbt)
Öffentliche Methode GetHashCode (von Object vererbt)
Öffentliche Methode GetLifetimeService (von MarshalByRefObject vererbt)
Geschützte Methode GetService (von Component vererbt)
Öffentliche Methode GetType (von Object vererbt)
Geschützte Methode HasTableMappings (von DataAdapter vererbt)
Geschützte Methode InitializeBatching (von DbDataAdapter vererbt)
Öffentliche Methode InitializeLifetimeService (von MarshalByRefObject vererbt)
Geschützte Methode MemberwiseClone() (von Object vererbt)
Geschützte Methode MemberwiseClone(Boolean) (von MarshalByRefObject vererbt)
Geschützte Methode OnFillError (von DataAdapter vererbt)
Geschützte Methode OnRowUpdated (von DbDataAdapter vererbt)
Geschützte Methode OnRowUpdating (von DbDataAdapter vererbt)
Öffentliche Methode ResetFillLoadOption (von DataAdapter vererbt)
Öffentliche Methode ShouldSerializeAcceptChangesDuringFill (von DataAdapter vererbt)
Öffentliche Methode ShouldSerializeFillLoadOption (von DataAdapter vererbt)
Geschützte Methode ShouldSerializeTableMappings (von DataAdapter vererbt)
Geschützte Methode TerminateBatching (von DbDataAdapter vererbt)
Öffentliche Methode ToString (von Component vererbt)
Öffentliche Methode Update(DataSet) (von DbDataAdapter vererbt)
Öffentliche Methode Update(array<DataRow[]) (von DbDataAdapter vererbt)
Öffentliche Methode Update(DataTable) (von DbDataAdapter vererbt)
Öffentliche Methode Update(DataSet, String) (von DbDataAdapter vererbt)
Geschützte Methode Update(array<DataRow[], DataTableMapping) (von DbDataAdapter vererbt)

Zum Anfang

Ereignisse

  Name Beschreibung
Öffentliches Ereignis Disposed (von Component vererbt)
Öffentliches Ereignis FillError (von DataAdapter vererbt)
Öffentliches Ereignis RowUpdated Tritt während eines Aufrufs der Update-Methode nach dem Ausführen eines Aktualisierungsbefehls für die Datenquelle ein. Es wird eine Aktualisierung versucht, und dann wird das Ereignis ausgelöst.
Öffentliches Ereignis RowUpdating Tritt während eines Aufrufs der Update-Methode vor dem Ausführen eines Aktualisierungsbefehls für die Datenquelle ein. Es wird eine Aktualisierung versucht, und dann wird das Ereignis ausgelöst.

Zum Anfang

Explizite Schnittstellenimplementierungen

  Name Beschreibung
Explizite SchnittstellenimplementierungPrivate Methode ICloneable.Clone Eine Beschreibung dieses Members finden Sie unter der ICloneable.Clone()-Methode.
Explizite SchnittstellenimplementierungPrivate Eigenschaft IDbDataAdapter.DeleteCommand (von DbDataAdapter vererbt)
Explizite SchnittstellenimplementierungPrivate Eigenschaft IDbDataAdapter.InsertCommand (von DbDataAdapter vererbt)
Explizite SchnittstellenimplementierungPrivate Eigenschaft IDbDataAdapter.SelectCommand (von DbDataAdapter vererbt)
Explizite SchnittstellenimplementierungPrivate Eigenschaft IDataAdapter.TableMappings (von DataAdapter vererbt)
Explizite SchnittstellenimplementierungPrivate Eigenschaft IDbDataAdapter.UpdateCommand (von DbDataAdapter vererbt)

Zum Anfang

Hinweise

Die SqlCeDataAdapter-Klasse fungiert als Brücke zwischen einer DataSet-Klasse und einer Datenquelle. Sie wird zum Abrufen von Daten aus und zum Speichern von Daten in der Datenquelle verwendet. Die SqlCeDataAdapter-Klasse stellt diese Verbindung bereit, indem mit der Fill-Methode Daten aus der Datenquelle in die DataSet-Klasse geladen und in der DataSet-Klasse vorgenommene Änderungen mit der Update-Methode zurück an die Datenquelle gesendet werden.

Wenn die SqlCeDataAdapter-Klasse eine DataSet-Klasse füllt, erstellt sie die für die zurückgegebenen Daten erforderlichen Tabellen und Spalten, sofern diese nicht bereits vorhanden sind. Primärschlüsselinformationen sind jedoch in dem implizit erstellten Schema nur enthalten, wenn die MissingSchemaAction-Eigenschaft auf AddWithKey festgelegt ist. Das Schema der DataSet-Klasse kann, einschließlich der Primärschlüsselinformationen, auch durch die SqlCeDataAdapter-Klasse erstellt werden, bevor es unter Verwendung der FillSchema-Methode mit Daten gefüllt wird.

Die SqlCeDataAdapter-Klasse enthält außerdem die Eigenschaften SelectCommand, InsertCommand, DeleteCommand, UpdateCommand und TableMappings für das Laden und Aktualisieren von Daten.

Wenn Sie eine Instanz der SqlCeDataAdapter-Klasse erstellen, werden die Eigenschaften auf die Anfangswerte festgelegt. Eine Liste dieser Werte finden Sie unter dem SqlCeDataAdapter-Konstruktor.

Beispiele

Im folgenden Beispiel werden die Klassen SqlCeCommand, SqlCeDataAdapter und SqlCeConnection verwendet, um Datensätze aus einer Datenquelle auszuwählen und eine DataSet-Klasse mit den ausgewählten Zeilen zu füllen. Anschließend wird die gefüllte DataSet-Klasse zurückgegeben. Dafür werden der Methode ein initialisiertes DataSet, eine Verbindungszeichenfolge und eine Abfragezeichenfolge übergeben, die eine SQL-SELECT-Anweisung darstellt.

Try
    Dim strDataSource As String
    strDataSource = "" & _
        "Data Source = C:\Program Files\" & _
        "Microsoft SQL Server Compact Edition\v3.5\Samples\" & _
        "Northwind.sdf"
    Dim conn As New SqlCeConnection
    conn.ConnectionString = strDataSource & ";Password='<password>'"

    Dim selectCmd As SqlCeCommand = conn.CreateCommand
    selectCmd.CommandText = "SELECT * FROM Employees"

    Dim adp As New SqlCeDataAdapter(selectCmd)

    Dim ds As New DataSet

    ' Note: Fill will leave the connection in its original state;
    ' In this case, the connection was closed so it will be left closed
    adp.Fill(ds)

    Console.WriteLine(("The SqlCeDataAdapter succesfully filled " & _
                       ds.Tables.Item(0).Rows.Count & " rows in the DataSet!"))
Catch ds As Exception
    Console.WriteLine(ds.Message)
Finally
    Console.WriteLine(vbNewLine & vbNewLine & vbNewLine & _
                      "Press any key to continue...")
    Console.ReadKey()
End Try

try
{
    string strDataSource =
        @"Data Source = C:\Program Files\" +
        @"Microsoft SQL Server Compact Edition\v3.5\Samples\" +
        @"Northwind.sdf";
    SqlCeConnection conn = new SqlCeConnection();
    conn.ConnectionString = strDataSource + ";Password='<password>'";

    SqlCeCommand selectCmd = conn.CreateCommand();
    selectCmd.CommandText = "SELECT * FROM Employees";

    SqlCeDataAdapter adp = new SqlCeDataAdapter(selectCmd);

    DataSet ds = new DataSet();

    // Note: Fill will leave the connection in its original state;
    // In this case, the connection was closed so it will be left closed
    //
    adp.Fill(ds);

    Console.WriteLine("The SqlCeDataAdapter succesfully filled " +
        ds.Tables[0].Rows.Count + " rows in the DataSet!");
}
catch (Exception ex)
{
    Console.WriteLine(ex.Message);
}
finally
{
    Console.WriteLine("\n\n\nPress any key to continue...");
    Console.ReadKey();
}

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

SqlCeConnection

SqlCeCommand

DataSet

DataTable