Partager via


ReadyState, propriété (RDS)

S’applique à : Access 2013, Office 2013

Indique la progression d’un DataControl lorsqu’il récupère des données dans son objet Recordset.

Paramètres et valeurs de retour

Définit ou renvoie l'une des valeurs suivantes.

Valeur

Description

adcReadyStateLoaded

La requête est encore en cours d'exécution et aucune ligne n'a été extraite. L'objet Recordset de DataControl n'est pas utilisable.

adcReadyStateInteractive

Le premier jeu de lignes récupéré par la requête actuelle a été stocké dans le Recordset de l'objet DataControl et peut être utilisé. Les lignes restantes sont encore en cours d'extraction.

adcReadyStateComplete

Toutes les lignes extraites par la requête en cours ont été stockées dans le Recordset de l'objet DataControl et peuvent être utilisées. Cet état est aussi défini lorsque l'opération a été interrompue en raison d'une erreur ou de la non-initialisation de l'objet Recordset.

Remarque

[!REMARQUE] Chaque fichier exécutable côté client utilisant ces constantes doit fournir les déclarations correspondantes. Vous pouvez couper et coller les déclarations de constante dont vous avez besoin dans le fichier Adcvbs.inc placé dans le dossier C:\Program Files\Common Files\System\MSADC.

Remarques

Utilisez l’événement onreadystatechange pour surveiller les modifications de la propriété ReadyState lors d’une requête asynchrone. C’est plus efficace que de vérifier régulièrement la valeur de la propriété.

Si une erreur se produit pendant une opération asynchrone, la propriété ReadyState devient adcReadyStateComplete, la propriété State passe de adStateExecuting à adStateClosed et la propriété Valeur de l’objet Recordset reste Nothing.