ObjectDataSourceView.ExecuteUpdate Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Effectue une opération de mise à jour en appelant la méthode identifiée par la UpdateMethod propriété et en utilisant les paramètres fournis dans les collections ou oldValues les keysvaluescollections.
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 -> intProtected Overrides Function ExecuteUpdate (keys As IDictionary, values As IDictionary, oldValues As IDictionary) As IntegerParamètres
- keys
- IDictionary
Clé IDictionary primaire à utiliser avec la UpdateMethod propriété pour effectuer l’opération de mise à jour de la base de données. S’il n’existe aucune clé associée à la méthode, passez null.
- values
- IDictionary
Valeurs IDictionary à utiliser avec l’opération UpdateMethod de mise à jour de la base de données. S’il n’existe aucun paramètre associé à la méthode, passez null.
- oldValues
- IDictionary
Qui IDictionary représente les valeurs d’origine dans le magasin de données sous-jacent. S’il n’existe aucun paramètre associé à la requête, passez null.
Retours
Nombre de lignes mises à jour ; ou -1, si le nombre n’est pas connu. Pour plus d’informations, consultez Update().
Exceptions
La CanInsert propriété retourne false.
oldValues est null ou vide et ConflictDetection est défini sur 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 ; utilisez plutôt la méthode exposée Update publiquement.
Les valeurs contenues dans les keys collections et values les collections 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, la ObjectDataSourceView réflexion utilise la 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 renvoi du nombre de lignes mises à jour, consultez Update.
