Status, propriété (champ ADO)
Indique l’état d’un objet Field.
Valeur de retour
Retourne une valeur FieldStatusEnum. La valeur par défaut est adFieldOK.
Remarques
État du champ d’enregistrement
Les modifications apportées à la valeur d’un objet Field de champ dans la collection Fields d’un objet Record sont mises en cache jusqu’à ce que la méthode update de l’objet soit appelée. À ce stade, si la modification de la valeur du champ a provoqué une erreur, OLE DB déclenche l’erreur DB_E_ERRORSOCCURRED (2147749409). La propriété Status de l’un des objets Field dans la collection Fields qui a provoqué l’erreur contiendra une valeur du FieldStatusEnum décrivant la cause du problème.
Pour améliorer les performances, les ajouts et les suppressions aux Fields collections de l’objet Record sont mis en cache jusqu’à ce que la méthode update soit appelée, puis les modifications sont apportées dans une mise à jour optimiste par lots. Si la méthode Update n’est pas appelée, le serveur n’est pas mis à jour. Si des mises à jour échouent, une erreur de fournisseur OLE DB (DB_E_ERRORSOCCURRED) 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, adFieldPendingInsert OR adFieldPermissionDenied. La propriété Status pour chaque Field peut être utilisée pour déterminer pourquoi le champ n’a pas été ajouté, modifié ou supprimé.
De nombreux types de problèmes rencontrés lors de l’ajout, de la modification ou de la suppression d’un champ de sont signalés via la propriété Status. Par exemple, si l’utilisateur supprime un Field, il est marqué pour suppression de la collection Fields. Si l'de mise à jour suivante renvoie une erreur, car l’utilisateur a tenté de supprimer un Field pour lequel il n’a pas d’autorisation, le Field aura un Status de adFieldPermissionDenied OR adFieldPendingDelete. L’appel de la méthode CancelUpdate restaure les valeurs d’origine et définit l'Status sur adFieldOK.
De même, la méthode Update peut renvoyer une erreur, car une nouvelle Field a été ajoutée et a donné une valeur inappropriée. Dans ce cas, la nouvelle Field figure dans la collection Fields et dispose d’un état adFieldPendingInsert et peut-être adFieldCantCreate (selon votre fournisseur). Vous pouvez fournir une valeur appropriée pour le nouveau Champ et appeler à nouveau Update.
État du champ Recordset
Les modifications apportées à la valeur d’un objet field Field dans la collection Fields d’un jeu d’enregistrements sont mises en cache jusqu’à ce que la méthode update de l’objet soit appelée. À ce stade, si la modification de la valeur du champ a provoqué une erreur, OLE DB déclenche l’erreur DB_E_ERRORSOCCURRED (2147749409). La propriété Status de l’un des objets Field dans la collection Fields qui a provoqué l’erreur contiendra une valeur du FieldStatusEnum décrivant la cause du problème.
S’applique à
Voir aussi
Status, propriété Example (Field) (VB)
Status, propriété - Exemple (VC++)