OleDbDataAdapter.UpdateCommand Eigenschap

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

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

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

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

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

Public Property UpdateCommand As OleDbCommand

Waarde van eigenschap

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

Kenmerken

DataSysDescriptionAttribute

Voorbeelden

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

private static OleDbDataAdapter CreateCustomerAdapter(
    OleDbConnection connection)
{
    OleDbDataAdapter dataAdapter = new OleDbDataAdapter();
    OleDbCommand command;
    OleDbParameter parameter;

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

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

    dataAdapter.SelectCommand = command;

    // Create the UpdateCommand.
    command = new OleDbCommand(
        "UPDATE dbo.Customers SET CustomerID = ?, CompanyName = ? " +
        "WHERE CustomerID = ?", connection);

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

    parameter = command.Parameters.Add(
        "oldCustomerID", OleDbType.Char, 5, "CustomerID");
    parameter.SourceVersion = DataRowVersion.Original;

    dataAdapter.UpdateCommand = command;

    return dataAdapter;
}

Private Function CreateCustomerAdapter( _
    ByVal connection As OleDbConnection) As OleDbDataAdapter

    Dim dataAdapter As New OleDbDataAdapter()
    Dim command As OleDbCommand
    Dim parameter As OleDbParameter

    ' Create the SelectCommand.
    command = New OleDbCommand("SELECT * FROM dbo.Customers " & _
        "WHERE Country = ? AND City = ?", connection)

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

    dataAdapter.SelectCommand = command

    ' Create the UpdateCommand.
    command = New OleDbCommand("UPDATE dbo.Customers " & _
        "SET CustomerID = ?, CompanyName = ? " & _
        "WHERE CustomerID = ?", connection)

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

    parameter = command.Parameters.Add( _
        "oldCustomerID", OleDbType.Char, 5, "CustomerID")
    parameter.SourceVersion = DataRowVersion.Original

    dataAdapter.UpdateCommand = command

    Return dataAdapter
End Function

Opmerkingen

Als Updatedeze eigenschap niet is ingesteld en de primaire-sleutelgegevens aanwezig zijn in de DataSeteigenschap, kan deze UpdateCommand 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 UpdateCommand deze is toegewezen aan een eerder gemaakte OleDbCommand, wordt deze OleDbCommand niet gekloond. Het UpdateCommand onderhoudt een verwijzing naar het eerder gemaakte OleDbCommand object.