OleDbDataAdapter.InsertCommand Eigenschap

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

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

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

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

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

Public Property InsertCommand As OleDbCommand

Waarde van eigenschap

Een OleDbCommand gebruikt tijdens Update(DataSet) het invoegen van records in de gegevensbron die overeenkomen met nieuwe rijen in de DataSet.

Kenmerken

DataSysDescriptionAttribute

Voorbeelden

In het volgende voorbeeld worden OleDbDataAdapter de SelectCommand en eigenschappen gemaakt en InsertCommand ingesteld. Hierbij wordt ervan uitgegaan dat u al een OleDbConnection object hebt gemaakt.

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

Opmerkingen

Als Updatedeze eigenschap niet is ingesteld en de primaire-sleutelgegevens aanwezig zijn in de DataSeteigenschap, kan deze InsertCommand automatisch worden gegenereerd als u de SelectCommand eigenschap instelt en de OleDbCommandBuilder. Vervolgens worden eventuele extra opdrachten die u niet instelt, gegenereerd door de OleDbCommandBuilder. Deze generatielogica vereist dat belangrijke kolomgegevens aanwezig zijn in de DataSet. Zie Opdrachten genereren met CommandBuilders voor meer informatie.

Wanneer InsertCommand deze is toegewezen aan een eerder gemaakte OleDbCommand, wordt deze OleDbCommand niet gekloond. Het InsertCommand onderhoudt een verwijzing naar het eerder gemaakte OleDbCommand object.

Zie ook

• DataAdapters en DataReaders