OleDbDataAdapter.InsertCommand-Eigenschaft

Während der Ausführung von Update kann, wenn diese Eigenschaft nicht festgelegt wurde und Primärschlüsselinformationen im DataSet vorhanden sind, der InsertCommand automatisch generiert werden, wenn Sie die SelectCommand-Eigenschaft festlegen und OleDbCommandBuilder verwenden. Anschließend werden alle zusätzlichen Befehle, die Sie nicht festlegen, von OleDbCommandBuilder generiert. Für diese Generierungslogik müssen im DataSet Schlüsselspalteninformationen vorhanden sein. Weitere Informationen finden Sie unter Automatically Generated Commands.

Wenn InsertCommand einem zuvor erstellten OleDbCommand zugeordnet wird, wird OleDbCommand nicht geklont. Der InsertCommand verwaltet einen Verweis auf das zuvor erstellte OleDbCommand-Objekt.

Hinweis
Wenn durch das Ausführen dieses Befehls Zeilen zurückgegeben werden, können diese Zeilen dem DataSet hinzugefügt werden. Dies ist davon abhängig, wie Sie die UpdatedRowSource-Eigenschaft des OleDbCommand-Objekts festlegen.

Im folgenden Beispiel werden ein OleDbDataAdapter erstellt sowie die SelectCommand-Eigenschaft und die InsertCommand-Eigenschaft festgelegt. Es wird davon ausgegangen, dass bereits ein OleDbConnection-Objekt erstellt wurde.

public static OleDbDataAdapter CreateCustomerAdapter(
    OleDbConnection connection)
{
    OleDbDataAdapter adapter = new OleDbDataAdapter();
    OleDbCommand command;

    // Create the SelectCommand.
    command = new OleDbCommand("SELECT CustomerID FROM Customers " +
        "WHERE Country = ? AND City = ?", connection);

    command.Parameters.Add("Country", OleDbType.VarChar, 15);
    command.Parameters.Add("City", OleDbType.VarChar, 15);

    adapter.SelectCommand = command;

    // Create the InsertCommand.
    command = new OleDbCommand(
        "INSERT INTO Customers (CustomerID, CompanyName) " +
        "VALUES (?, ?)", connection);

    command.Parameters.Add(
        "CustomerID", OleDbType.Char, 5, "CustomerID");
    command.Parameters.Add(
        "CompanyName", OleDbType.VarChar, 40, "CompanyName");

    adapter.InsertCommand = command;
    return adapter;
}

.NET Framework

.NET Framework Client Profile

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

Referenz

Weitere Ressourcen