IDbDataAdapter.InsertCommand Eigenschaft

Definition

Namespace:

System.Data

Assembly:

System.Data.Common.dll

Ruft eine SQL-Anweisung ab, mit der neue Datensätze in die Datenquelle eingefügt werden, oder legt diese fest.

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

public System.Data.IDbCommand? InsertCommand { get; set; }

member this.InsertCommand : System.Data.IDbCommand with get, set

Public Property InsertCommand As IDbCommand

Eigenschaftswert

IDbCommand

Ein IDbCommand, das während der Ausführung von Update(DataSet) verwendet wird, um Datensätze in die Datenquelle einzufügen, die neuen Zeilen im Dataset entsprechen.

Beispiele

Im folgenden Beispiel wird eine instance der geerbten OleDbDataAdapter Klasse erstellt und die SelectCommand Eigenschaften 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 DataSetvorhanden sind, kann automatisch InsertCommand generiert werden, wenn Sie die SelectCommand Eigenschaft eines .NET Framework-Datenanbieters festlegen. Anschließend werden alle zusätzlichen Befehle, die Sie nicht festlegen, vom CommandBuilder generiert. Diese Generierungslogik erfordert, dass wichtige Spalteninformationen im DataSetvorhanden sind. Weitere Informationen finden Sie unter Generieren von Befehlen mit CommandBuilders.

Wenn InsertCommand einem zuvor erstellten IDbCommandzugewiesen ist, wird der IDbCommand nicht geklont. Der InsertCommand verwaltet einen Verweis auf das zuvor erstellte IDbCommand Objekt.

Hinweis

Wenn die Ausführung dieses Befehls Zeilen zurückgibt, können diese Zeilen dem DataSet hinzugefügt werden, je nachdem, wie Sie die UpdatedRowSource Eigenschaft des IDbCommand Objekts festlegen.