SqlCeCommandBuilder.GetInsertCommand-Methode

Ruft das für Einfügevorgänge in der Datenbank erforderliche, automatisch generierte SqlCeCommand-Objekt ab, wenn eine Anwendung die öffentliche Update-Methode für dieSqlCeDataAdapter-Klasse aufruft.

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

Syntax

'Declaration
Public Function GetInsertCommand As SqlCeCommand
'Usage
Dim instance As SqlCeCommandBuilder
Dim returnValue As SqlCeCommand

returnValue = instance.GetInsertCommand()

public SqlCeCommand GetInsertCommand()

public:
SqlCeCommand^ GetInsertCommand()

member GetInsertCommand : unit -> SqlCeCommand 

public function GetInsertCommand() : SqlCeCommand

Rückgabewert

Typ: System.Data.SqlServerCe.SqlCeCommand
Das für Einfügevorgänge erforderliche, automatisch generierte SqlCeCommand-Objekt.

Hinweise

Anwendungen können zur Information oder zur Fehlerbehebung die GetInsertCommand-Methode verwenden, da diese das auszuführende SqlCeCommand-Objekt zurückgibt.

Sie können GetInsertCommand auch als Grundlage für einen geänderten Befehl verwenden. Sie können z. B. die GetInsertCommand-Methode aufrufen, eine der Eigenschaften ändern und dies anschließend explizit für die SqlCeDataAdapter-Klasse festlegen.

Nach dem erstmaligen Generieren der SQL-Anweisung muss die öffentliche RefreshSchema()-Methode explizit aufgerufen werden, wenn die Anwendung die Anweisung ändert. Andernfalls verwendet die öffentliche GetInsertCommand-Methode weiter die Informationen der vorherigen Anweisung, die möglicherweise nicht korrekt sind. Die SQL-Anweisungen werden erstmalig generiert, wenn die Anwendung Update oder GetInsertCommand aufruft.

Beispiele

Im folgenden Beispiel wird das Aufrufen der GetInsertCommand-Methode von der SqlCeCommandBuilder-Klasse veranschaulicht.

Try
    Dim conn As New SqlCeConnection("Data Source = MyDatabase.sdf")
    conn.Open()

    Dim cmd As SqlCeCommand = conn.CreateCommand()
    cmd.CommandText = "SELECT * FROM employees"

    Dim adp As New SqlCeDataAdapter(cmd)

    Dim cb As New SqlCeCommandBuilder()
    cb.DataAdapter = adp

    MessageBox.Show(cb.GetUpdateCommand().CommandText)
    MessageBox.Show(cb.GetInsertCommand().CommandText)
    MessageBox.Show(cb.GetDeleteCommand().CommandText)

    Dim ds As New DataSet("test")
    adp.Fill(ds)

    ' Modify the contents of the DataSet
    '
    ds.Tables(0).Rows(0)("First Name") = "Joe"

    adp.Update(ds)

Catch e1 As Exception
    Console.WriteLine(e1.ToString())
End Try

try
{
    SqlCeConnection conn = new SqlCeConnection("Data Source = MyDatabase.sdf");
    conn.Open();

    SqlCeCommand cmd = conn.CreateCommand();
    cmd.CommandText = "SELECT * FROM employees";

    SqlCeDataAdapter adp = new SqlCeDataAdapter(cmd);

    SqlCeCommandBuilder cb = new SqlCeCommandBuilder();
    cb.DataAdapter = adp;

    MessageBox.Show(cb.GetUpdateCommand().CommandText);
    MessageBox.Show(cb.GetInsertCommand().CommandText);
    MessageBox.Show(cb.GetDeleteCommand().CommandText);

    DataSet ds = new DataSet("test");
    adp.Fill(ds);

    // Modify the contents of the DataSet
    //
    ds.Tables[0].Rows[0]["First Name"] = "Joe";

    adp.Update(ds);

}
catch (Exception e1)
{
    Console.WriteLine(e1.ToString());
}

Siehe auch

Verweis

SqlCeCommandBuilder Klasse

GetInsertCommand-Überladung

System.Data.SqlServerCe-Namespace