Partager via


DataSourceView.ExecuteUpdate(IDictionary, IDictionary, IDictionary) Méthode

Définition

Exécute une opération de mise à jour dans la liste des données que l'objet DataSourceView représente.

protected:
 virtual int ExecuteUpdate(System::Collections::IDictionary ^ keys, System::Collections::IDictionary ^ values, System::Collections::IDictionary ^ oldValues);
protected virtual int ExecuteUpdate (System.Collections.IDictionary keys, System.Collections.IDictionary values, System.Collections.IDictionary oldValues);
abstract member ExecuteUpdate : System.Collections.IDictionary * System.Collections.IDictionary * System.Collections.IDictionary -> int
override this.ExecuteUpdate : System.Collections.IDictionary * System.Collections.IDictionary * System.Collections.IDictionary -> int
Protected Overridable Function ExecuteUpdate (keys As IDictionary, values As IDictionary, oldValues As IDictionary) As Integer

Paramètres

keys
IDictionary

IDictionary d'objet ou clés de ligne à mettre à jour par l'opération de mise à jour.

values
IDictionary

IDictionary de paires nom/valeur qui représentent les éléments de données et leurs nouvelles valeurs.

oldValues
IDictionary

IDictionary de paires nom/valeur qui représentent les éléments de données et leurs valeurs d'origine.

Retours

Int32

Nombre d'éléments mis à jour au sein du stockage de données sous-jacent.

Exceptions

Exemples

L’exemple de code suivant montre comment une classe qui étend la DataSourceView classe peut remplacer la CanUpdate propriété et la ExecuteUpdate méthode. Cet exemple de code fait partie d’un exemple plus grand fourni pour la DataSourceView classe.

// The CsvDataSourceView does not currently
// permit update operations. You can modify or
// extend this sample to do so.
public override bool CanUpdate {
    get {
        return false;
    }
}
protected override int ExecuteUpdate(IDictionary keys, IDictionary values, IDictionary oldValues)
{
    throw new NotSupportedException();
}
   ' The CsvDataSourceView does not currently
   ' permit update operations. You can modify or
   ' extend this sample to do so.
   Public Overrides ReadOnly Property CanUpdate() As Boolean
      Get
         Return False
      End Get
   End Property

   Protected Overrides Function ExecuteUpdate(keys As IDictionary, _
                                              values As IDictionary, _
                                              oldValues As IDictionary) As Integer
      Throw New NotSupportedException()
   End Function 'ExecuteUpdate

End Class

Remarques

Les contrôles liés aux données peuvent déterminer si l’opération ExecuteUpdate est prise en charge par un contrôle de source de données à l’aide de la DataSourceControl.GetView méthode pour récupérer l’objet DataSourceView et vérifier la valeur de la CanUpdate propriété.

Le keys paramètre représente les clés d’objet ou de ligne des données à mettre à jour. Pour les sources de données qui représentent des données relationnelles, telles que le SqlDataSource contrôle, le keys paramètre est une collection de clés primaires de base de données. Dans d’autres scénarios, le keys paramètre est une collection de paires nom/valeur et est utilisé pour filtrer une liste de données. Toutes les données correspondant à une paire nom/valeur sont mises à jour avec les valeurs trouvées dans le values paramètre, qui est un ensemble de paires nom/valeur qui représente de nouvelles valeurs pour les champs ou colonnes existants.

Notes

L’implémentation par défaut de la DataSourceView classe consiste à lever une NotSupportedException exception. Si vous étendez la DataSourceView classe, remplacez la ExecuteUpdate méthode si votre classe prend en charge la mise à jour des données dans le stockage de données sous-jacent.

S’applique à

Voir aussi