ReadyState, propriété (RDS)
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 à
Voir aussi
ReadyState, exemple de propriété (VBScript)
Cancel, méthode (RDS)
ExecuteOptions, propriété (RDS)