DbDataAdapter.InsertCommand Eigenschaft

Definition

Ruft einen Befehl ab, mit dem neue Datensätze in die Datenquelle eingefügt werden, oder legt diesen fest.Gets or sets a command used to insert new records into the data source.

public:
 property System::Data::Common::DbCommand ^ InsertCommand { System::Data::Common::DbCommand ^ get(); void set(System::Data::Common::DbCommand ^ value); };
[System.ComponentModel.Browsable(false)]
public System.Data.Common.DbCommand InsertCommand { get; set; }
member this.InsertCommand : System.Data.Common.DbCommand with get, set
Public Property InsertCommand As DbCommand

Eigenschaftswert

Ein IDbCommand, der während der Ausführung von Update(DataSet) verwendet wird, um Datensätze in die Datenquelle einzufügen, die neuen Zeilen im Dataset entsprechen.A IDbCommand used during Update(DataSet) to insert records in the data source for new rows in the data set.

Attribute

Beispiele

Im folgenden Beispiel wird die abgeleitete OleDbDataAdapter Klasse erstellt und einige ihrer Eigenschaften festgelegt.The following example creates the derived class OleDbDataAdapter and sets some of its properties.

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 während nicht festgelegt ist und Primärschlüssel Informationen DataSetin vorhanden sind, InsertCommand wird automatisch generiert.During Update, if this property is not set and primary key information is present in the DataSet, the InsertCommand will be automatically generated.

Gilt für:

Siehe auch