IDbDataAdapter.UpdateCommand Eigenschap

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

public System.Data.IDbCommand UpdateCommand { get; set; }

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

Public Property UpdateCommand As IDbCommand

Waarde van eigenschap

Een IDbCommand gebruikt tijdens Update(DataSet) het bijwerken van records in de gegevensbron voor gewijzigde rijen in de gegevensset.

Voorbeelden

In het volgende voorbeeld wordt een exemplaar van de overgenomen klasse gemaakt OleDbDataAdapter en worden de SelectCommand en UpdateCommand eigenschappen 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 deze eigenschap tijdens Update niet is ingesteld en de primaire-sleutelgegevens aanwezig zijn in de DataSet, kan de UpdateCommand automatisch worden gegenereerd als u de eigenschap SelectCommand van een .NET Framework-gegevensprovider instelt. Vervolgens worden eventuele extra opdrachten die u niet instelt, gegenereerd door CommandBuilder. 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 IDbCommand, wordt deze IDbCommand niet gekloond. Het UpdateCommand onderhoudt een verwijzing naar het eerder gemaakte IDbCommand object.