Partager via

Status, propriété (champ ADO)

  • Article

S’applique à : Access 2013, Office 2013

Indique l'état d'un objet Field.

Valeur renvoyée

Renvoie une valeur FieldStatusEnum. La valeur par défaut est adFieldOK.

Remarques

Cette propriété renvoie toujours adFieldOK pour les champs d'un objet Recordset.

Les additions et les suppressions effectuées sur les collections Fields de l'objet Record sont mises en cache jusqu'à ce que la méthode Update soit appelée. La propriété Status vous permet de déterminer les champs ayant été correctement ajoutés ou supprimés.

Pour améliorer les performances, les modifications de schéma sont mises en cache jusqu’à ce que Update soit appelée, puis les modifications sont effectuées dans une mise à jour optimiste par lot. Si la méthode Update n’est pas appelée, le serveur n’est pas mis à jour. Si des mises à jour échouent, une erreur est retournée et la propriété Status indique les valeurs combinées de l’opération et du code d’état d’erreur. Par exemple, adFieldPendingInsertOUadFieldPermissionDenied. La propriété Status de chaque champ peut être utilisée pour déterminer pourquoi le champ n’a pas été ajouté, modifié ou supprimé. L’état est exposé de manière significative uniquement sur l’enregistrement. Collection Fields et non l’objet Recordset. Collection Fields .

Deux problèmes peuvent survenir lors de l'ajout, de la modification ou de la suppression d'un objet Field. Si l'utilisateur supprime un objet Field, il est marqué pour suppression dans la collection Fields. Si la mise à jour suivante renvoie une erreur parce que l’utilisateur a tenté de supprimer un champ pour lequel il n’a pas l’autorisation, le champ a l’état adFieldPermissionDeniedOUadFieldPendingDelete. Le fait d'appeler la méthode CancelUpdate restaure les valeurs d'origine et donne à la propriété Status la valeur adFieldOK. De même, la méthode Update peut renvoyer une erreur lorsqu'un nouvel objet Field a été ajouté et que la valeur qui lui a été attribuée est incorrecte. Dans ce cas, le nouvel objet Field est stocké dans la collection Fields; prend l'état adFieldPendingInsert, voire adFieldCantCreate. Vous pouvez donner au nouvel objet Field une valeur correcte et appeler à nouveau la méthode Update. Remarque : si vous appelez Resync, une requête est renvoyée au fournisseur.