Partager via


ObjectDataSourceView.ExecuteUpdate Méthode

Définition

Exécute une opération de mise à jour en appelant la méthode qui est identifiée par la propriété UpdateMethod et à l'aide des paramètres fournis dans les collections keys, values ou oldValues.

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

Paramètres

keys
IDictionary

IDictionary de clés primaires à utiliser avec la propriété UpdateMethod pour exécuter l'opération de mise à jour de la base de données. Si aucune clé n'est associée à la méthode, passez la valeur null.

values
IDictionary

Un IDictionary de valeurs à utiliser avec UpdateMethod pour exécuter l'opération de mise à jour de base de données. Si aucun paramètre n'est associé à la méthode, passez la valeur null.

oldValues
IDictionary

Un IDictionary qui représente les valeurs d'origine dans le magasin de données sous-jacent. Si aucun paramètre n'est associé à la requête, passez la valeur null.

Retours

Nombre de lignes mises à jour ; sinon, -1 si le nombre n'est pas connu. Pour plus d'informations, consultez Update().

Exceptions

La propriété CanInsert retourne la valeur false.

oldValues est null ou vide et ConflictDetection a la valeur CompareAllValues.

Remarques

La ObjectDataSourceView classe implémente la méthode héritée ExecuteUpdate pour mettre à jour les données à l’aide d’un objet métier. Les développeurs de pages et les auteurs de contrôles liés aux données n’appellent pas directement la ExecuteUpdate méthode ; à la place, utilisez la méthode exposée Update publiquement.

Les valeurs contenues dans les keys collections et values sont évaluées et fusionnées avec toutes les valeurs contenues dans la UpdateParameters collection. Si la ConflictDetection propriété est définie sur la CompareAllValues valeur , les valeurs contenues dans la oldValues collection sont mises en forme avec la OldValuesParameterFormatString propriété et sont également fusionnées.

Avant l’exécution de l’opération de mise à jour, la OnUpdating méthode est appelée pour déclencher l’événement Updating . Vous pouvez gérer cet événement pour examiner les valeurs des paramètres et effectuer tout prétraitement avant une mise à jour. Pour effectuer une opération de mise à jour, utilise la ObjectDataSourceView réflexion pour appeler la méthode identifiée par la UpdateMethod propriété et tous les paramètres associés dans la keys collection, puis l’exécute. Une fois l’opération terminée, la OnUpdated méthode est appelée pour déclencher l’événement Updated . Vous pouvez gérer cet événement pour examiner les valeurs de retour, les codes d’erreur et effectuer tout post-traitement.

Pour plus d’informations sur le retour du nombre de lignes mises à jour, consultez Update.

S’applique à

Voir aussi