Recordset2.Update, méthode (DAO)
S’applique à : Access 2013, Office 2013
Syntaxe
expression . Update(UpdateType, Force)
Expression Variable qui représente un objet Recordset2 .
Paramètres
Nom |
Obligatoire/facultatif |
Type de données |
Description |
|---|---|---|---|
UpdateType |
Facultatif |
Long |
A UpdateTypeEnum constante indiquant le type de mise à jour, comme spécifié dans les paramètres (espaces). |
Force |
Facultatif |
Booléen |
Valeur booléenne indiquant si les modifications doivent être forcées ou non dans la base de données, indépendamment du fait que les données sous-jacentes aient été modifiées par un autre utilisateur depuis l'appel de AddNew, Delete ou Edit. Si la valeur est True, les modifications sont forcées et les modifications apportées par d'autres utilisateurs sont tout simplement remplacées. Si la valeur est False (valeur par défaut), les modifications apportées par d'autres utilisateurs tandis que la mise à jour est en attente entraîneront l'échec de la mise à jour pour les modifications en conflit. Aucune erreur ne se produit, mais les propriétés BatchCollisionCount et BatchCollisions indiquent le nombre de conflits et les lignes affectées par les conflits, respectivement (espaces de travail ODBCDirect uniquement). |
Remarques
Utilisez mise à jour pour enregistrer l’enregistrement actif et toutes les modifications apportées à celui-ci.
Importante
Enregistrer les modifications apportées à l’enregistrement actif
- Vous utilisez le modifier ou AddNew méthode, puis accéder à un autre enregistrement sans utiliser première mise à jour.
- Vous utilisez modifier ou AddNew, puis utilisez modifier ou AddNew nouveau sans utiliser première mise à jour.
- Vous définissez la signet propriété vers un autre enregistrement.
- Vous fermez le jeu d’enregistrements sans utiliser première mise à jour.
- vous annulez l'opération Edit par le biais de la méthode CancelUpdate.
Pour modifier un enregistrement, utilisez la méthode Edit pour copier le contenu de l'enregistrement actif dans la mémoire tampon de la copie. Si vous n'utilisez pas d'abord la méthode Edit, une erreur se produit lorsque vous utilisez Update ou que vous tentez de modifier la valeur d'un champ.
Dans un espace de travail ODBCDirect, vous pouvez effectuer par lot mises à jour, sous réserve la bibliothèque curseur prend en charge les mises à jour du lot et le jeu d’enregistrements a été ouvert avec l’option de verrouillage par lot optimiste.
Dans un espace de travail Microsoft Access, lorsque le jeu d’enregistrements d’objet LockEdits paramètre de la propriété est vrai (verrouillage pessimiste) dans un environnement multi-utilisateurs, l’enregistrement reste verrouillé à partir du moment modifier sert jusqu'à ce que le mise à jour méthode est exécutée ou la modification est annulée. Si le LockEdits paramètre de la propriété est faux (verrouillage optimiste), l’enregistrement est verrouillé et par rapport à l’enregistrement déjà modifiée juste avant qu’il est mis à jour dans la base de données. Si l’enregistrement a changé, car vous avez utilisé le modifier méthode, le mise à jour opération échoue. Base de données Microsoft Access connectées moteur ODBC et bases de données ISAM toujours utilisent le verrouillage optimiste. Pour continuer la mise à jour opération avec vos modifications, utilisez la mise à jour méthode nouveau. Pour revenir à l’enregistrement tel que l’autre utilisateur l’a modifié, actualisez l’enregistrement actif à l’aide de la commande Move 0.
Remarque
[!REMARQUE] Pour ajouter, modifier ou supprimer un enregistrement, un index unique doit exister au niveau de l'enregistrement de la source de données sous-jacente. À défaut, une erreur de type « Autorisation refusée » se produit consécutivement à l'appel d'une méthode Update, Edit ou AddNew dans un espace de travail Microsoft Access ; dans un espace de travail ODBCDirect, l'appel de Delete provoque une erreur de type « Argument incorrect ».