Share via

ReadyState, propriété (RDS)

  • Article

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

Important

À compter de Windows 8 et Windows Server 2012, les composants serveur RDS ne sont plus inclus dans le système d’exploitation Windows (voir le Guide pratique sur la compatibilité de Windows Server 2012 et Windows 8 pour plus de détails). Les composants clients RDS seront supprimés dans une version ultérieure de Windows. Évitez d'utiliser cette fonctionnalité dans de nouveaux travaux de développement, et prévoyez de modifier les applications qui utilisent actuellement cette fonctionnalité. Les applications qui utilisent RDS doivent migrer vers WCF Data Service.

Paramètres et valeurs de retour

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

Valeur Description
adcReadyStateLoaded La requête actuelle est toujours en cours d’exécution et aucune ligne n’a été extraite. Le Recordset de l’objet DataControl n’est pas disponible.
adcReadyStateInteractive Un ensemble initial de lignes extraites par la requête en cours a été stocké dans le Recordset de l’objet DataControl et peut être utilisé. Les lignes restantes sont toujours extraites.
adcReadyStateComplete Toutes les lignes récupérées par la requête en cours ont été stockées dans le Recordset de l’objet DataControl et peuvent être utilisées.

Cet état existe également si une opération a été abandonnée en raison d’une erreur ou si l’objet Recordset n’est pas initialisé.

Notes

Chaque fichier exécutable côté client qui utilise ces constantes doit fournir des déclarations pour elles. Vous pouvez couper et coller les déclarations de constantes souhaitées à partir du fichier Adcvbs.inc, situées dans le dossier d’installation par défaut de la bibliothèque RDS.

Notes

Utilisez l’événement onReadyStateChange pour surveiller les modifications apportées à la propriété ReadyState pendant une opération de requête asynchrone. Cela 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é Recordset de l’objet Value reste Nothing.

S'applique à

DataControl, objet (RDS)

Voir aussi

ReadyState, exemple de propriété (VBScript)
Cancel, méthode (RDS)
ExecuteOptions, propriété (RDS)