SqlCeDataAdapter-Klasse

Artikel
01/17/2011

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

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

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