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.
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 -> intProtected Overrides Function ExecuteUpdate (keys As IDictionary, values As IDictionary, oldValues As IDictionary) As IntegerParamè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.
