OleDbDataAdapter.UpdateCommand OleDbDataAdapter.UpdateCommand OleDbDataAdapter.UpdateCommand OleDbDataAdapter.UpdateCommand Property

Définition

Récupère ou définit une instruction SQL ou une procédure stockée utilisée pour mettre à jour les enregistrements dans la source de données.Gets or sets an SQL statement or stored procedure used to update records in the data source.

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; }
member this.UpdateCommand : System.Data.OleDb.OleDbCommand with get, set
Public Property UpdateCommand As OleDbCommand

Valeur de propriété

OleDbCommand utilisé lors de Update(DataSet) pour mettre à jour les enregistrements dans la source de données qui correspondent à des lignes modifiées dans le DataSet.An OleDbCommand used during Update(DataSet) to update records in the data source that correspond to modified rows in the DataSet.

Exemples

L’exemple suivant crée un OleDbDataAdapter et définit le SelectCommand et UpdateCommand propriétés.The following example creates an OleDbDataAdapter and sets the SelectCommand and UpdateCommand properties. Il suppose que vous avez déjà créé un OleDbConnection objet.It assumes that you have already created an OleDbConnection object.

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 OleDbDataAdapter = 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

Remarques

Au cours de Update, si cette propriété n’est pas définie et informations de clé primaire sont présentes dans le DataSet, le UpdateCommand peut être généré automatiquement si vous définissez la SelectCommand propriété et utiliser le OleDbCommandBuilder.During Update, if this property is not set and primary key information is present in the DataSet, the UpdateCommand can be generated automatically if you set the SelectCommand property and use the OleDbCommandBuilder. Ensuite, toutes les commandes que vous ne définissez pas sont générées par le OleDbCommandBuilder.Then, any additional commands that you do not set are generated by the OleDbCommandBuilder. Cette logique de génération nécessite des informations de colonne clé dans le DataSet.This generation logic requires key column information to be present in the DataSet. Pour plus d’informations, consultez générant des commandes avec CommandBuilders.For more information, see Generating Commands with CommandBuilders.

Lorsque UpdateCommand est affecté à un créé précédemment OleDbCommand, le OleDbCommand ne sont pas clonés.When UpdateCommand is assigned to a previously created OleDbCommand, the OleDbCommand is not cloned. Le UpdateCommand conserve une référence à l’élément précédemment créé OleDbCommand objet.The UpdateCommand maintains a reference to the previously created OleDbCommand object.

Notes

Si l’exécution de cette commande retourne des lignes, ces lignes peuvent être fusionnées avec les DataSet selon la façon dont vous définissez la UpdatedRowSource propriété de la OleDbCommand objet.If execution of this command returns rows, these rows may be merged with the DataSet depending on how you set the UpdatedRowSource property of the OleDbCommand object.

S’applique à