OleDbDataAdapter.InsertCommand Eigenschaft

public:
 property System::Data::OleDb::OleDbCommand ^ InsertCommand { System::Data::OleDb::OleDbCommand ^ get(); void set(System::Data::OleDb::OleDbCommand ^ value); };

public System.Data.OleDb.OleDbCommand? InsertCommand { get; set; }

[System.Data.DataSysDescription("DbDataAdapter_InsertCommand")]
public System.Data.OleDb.OleDbCommand InsertCommand { get; set; }

public System.Data.OleDb.OleDbCommand InsertCommand { get; set; }

member this.InsertCommand : System.Data.OleDb.OleDbCommand with get, set

[<System.Data.DataSysDescription("DbDataAdapter_InsertCommand")>]
member this.InsertCommand : System.Data.OleDb.OleDbCommand with get, set

Public Property InsertCommand As OleDbCommand

Eigenschaftswert

Wird OleDbCommand während des Einfügens von Update(DataSet) Datensätzen in die Datenquelle verwendet, die neuen Zeilen in der DataSetDatenquelle entsprechen.

Attribute

DataSysDescriptionAttribute

Beispiele

Im folgenden Beispiel wird eine OleDbDataAdapter und die SelectCommand Eigenschaften erstellt und InsertCommand festgelegt. Es wird davon ausgegangen, dass Sie bereits ein OleDbConnection Objekt erstellt haben.

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;
}

Public Shared Function CreateCustomerAdapter( _
    connection As OleDbConnection) As OleDbDataAdapter 
  
    Dim adapter As New OleDbDataAdapter()
    Dim command As OleDbCommand

    ' 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
End Function

Hinweise

Wenn Updatediese Eigenschaft nicht festgelegt ist und Primärschlüsselinformationen in der DataSetDatei vorhanden sind, kann dies InsertCommand automatisch generiert werden, wenn Sie die SelectCommand Eigenschaft festlegen und die OleDbCommandBuilder. Anschließend werden alle zusätzlichen Befehle, die Sie nicht festlegen, von dem OleDbCommandBuildergeneriert. Diese Generierungslogik erfordert, dass wichtige Spalteninformationen in der DataSet. Weitere Informationen finden Sie unter Generieren von Befehlen mit CommandBuilder-Objekten.

Wenn InsertCommand einem zuvor erstellten OleDbCommandElement zugewiesen wird, wird dies OleDbCommand nicht geklont. Der InsertCommand Verwaltet einen Verweis auf das zuvor erstellte OleDbCommand Objekt.

Weitere Informationen

• "DataAdapters" und "DataReaders"