ObjectDataSourceView.Update(IDictionary, IDictionary, IDictionary) 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
.
public:
int Update(System::Collections::IDictionary ^ keys, System::Collections::IDictionary ^ values, System::Collections::IDictionary ^ oldValues);
public int Update (System.Collections.IDictionary keys, System.Collections.IDictionary values, System.Collections.IDictionary oldValues);
override this.Update : System.Collections.IDictionary * System.Collections.IDictionary * System.Collections.IDictionary -> int
Public Function Update (keys As IDictionary, values As IDictionary, oldValues As IDictionary) As Integer
Paramètres
- keys
- IDictionary
IDictionary des valeurs de clés utilisées pour identifier l'élément à mettre à jour. Ces paramètres sont utilisés avec la méthode spécifiée par la propriété UpdateMethod pour exécuter l'opération de mise à jour. Si aucun paramètre n'est associé à la méthode, passez la valeur null
.
- values
- IDictionary
IDictionary de nouvelles valeurs à appliquer à la source de données. Ces paramètres sont utilisés avec la méthode spécifiée par la propriété UpdateMethod pour exécuter l'opération de mise à jour de la base de données. Si aucun paramètre n'est associé à la méthode, passez la valeur null
.
- oldValues
- IDictionary
IDictionary qui contient les valeurs supplémentaires ne correspondant pas à une clé utilisée pour correspondre à l'élément dans la source de données. Les valeurs de ligne sont passées à la méthode de suppression uniquement si la propriété ConflictDetection a pour valeur le champ CompareAllValues.
Retours
Nombre de lignes mises à jour ; sinon, -1 si le nombre n'est pas connu.
Remarques
La valeur de retour par défaut est -1, ce qui signifie qu’un nombre inconnu de lignes a été mis à jour. Pour retourner une autre valeur, définissez la AffectedRows propriété de l’objet ObjectDataSourceStatusEventArgs de l’événement Updated . Le nombre de lignes affectées est généralement retourné par la Update
méthode de l’objet métier, et cette valeur est disponible à partir de la ReturnValue propriété du ObjectDataSourceStatusEventArgs paramètre de l’événement Updated .
La Update méthode appelle la ExecuteUpdate méthode, en passant les keys
paramètres , values
et oldValues
.