IDbDataAdapter.UpdateCommand Propriété

Définition

Espace de noms:

System.Data

Assemblys:

netstandard.dll, System.Data.Common.dll

Obtient ou définit une instruction SQL utilisée pour mettre à jour les enregistrements dans la source de données.

C#

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

Valeur de propriété

IDbCommand

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.

Exemples

L’exemple suivant crée une instance de la classe héritée OleDbDataAdapter et définit les SelectCommand propriétés et UpdateCommand . Elle suppose que vous avez déjà créé un OleDbConnection objet.

C#

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;
}

Remarques

Pendant Update, si cette propriété n’est pas définie et que des informations sur la clé primaire sont présentes dans , DataSetle UpdateCommand peut être généré automatiquement si vous définissez la SelectCommand propriété d’un fournisseur de données .NET Framework. Ensuite, toutes les commandes supplémentaires que vous ne définissez pas sont générées par CommandBuilder. Cette logique de génération nécessite que les informations de colonne clé soient présentes dans le DataSet. Pour plus d’informations, consultez Génération de commandes avec CommandBuilders.

Quand UpdateCommand est affecté à un créé précédemment IDbCommand, le n’est IDbCommand pas cloné. Conserve UpdateCommand une référence à l’objet créé IDbCommand précédemment.

Notes

Si l’exécution de cette commande retourne des lignes, ces lignes sont ajoutées à .DataSet

S’applique à