IDbDataAdapter.UpdateCommand Propriété

Définition

Obtient ou définit une instruction SQL utilisée pour mettre à jour les enregistrements dans la source de données.Gets or sets an SQL statement used to update records in the data source.

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

Valeur de propriété

IDbCommand utilisé pendant Update(DataSet) pour mettre à jour les enregistrements de la source de données pour des lignes modifiées dans le groupe de données.An IDbCommand used during Update(DataSet) to update records in the data source for modified rows in the data set.

Exemples

L’exemple suivant crée une instance de la classe OleDbDataAdapter héritée et définit les SelectCommand propriétés UpdateCommand et.The following example creates an instance of the inherited OleDbDataAdapter class, and sets the SelectCommand and UpdateCommand properties. Il part du principe que vous avez déjà OleDbConnection créé un objet.It assumes 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 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

Pendant Update, si cette propriété n’est pas définie et que les informations de clé primaire DataSetsont présentes UpdateCommand dans le, le peut être généré automatiquement SelectCommand si vous définissez la propriété d’un fournisseur de données .NET Framework.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 of a .NET Framework data provider. Ensuite, toutes les commandes supplémentaires que vous ne définissez pas sont générées par CommandBuilder.Then, any additional commands that you do not set are generated by the CommandBuilder. Cette logique de génération requiert que les informations sur les colonnes clés DataSetsoient présentes dans le.This generation logic requires key column information to be present in the DataSet. Pour plus d’informations, consultez génération de commandes avec CommandBuilders.For more information see Generating Commands with CommandBuilders.

Lorsque UpdateCommand est assigné à un précédemment créé IDbCommand, le IDbCommand n’est pas cloné.When UpdateCommand is assigned to a previously created IDbCommand, the IDbCommand is not cloned. Le UpdateCommand gère une référence à l’objet créé IDbCommand précédemment.The UpdateCommand maintains a reference to the previously created IDbCommand object.

Notes

Si l’exécution de cette commande retourne des lignes, ces lignes sont ajoutées DataSetà.If execution of this command returns rows, these rows are added to the DataSet.

S’applique à