DataControl, objet (RDS)
Lie une requête de données Recordset à un ou plusieurs contrôles (par exemple, une zone de texte, un contrôle de grille ou une zone de liste modifiable) pour afficher le jeu d’enregistrements données sur une page Web.
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 Windows 8 et livre de recettes de compatibilité Windows Server 2012 pour plus de détails). Les composants clients RDS seront supprimés dans une prochaine version de Windows. Évitez d’utiliser cette fonctionnalité dans le nouveau travail 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 .
Syntaxe
<OBJECT CLASSID="clsid:BD96C556-65A3-11D0-983A-00C04FC29E33" ID="DataControl"
<PARAM NAME="Connect" VALUE="DSN=DSNName;UID=MyUserID;PWD=<password>;">
<PARAM NAME="Server" VALUE="https://awebsrvr">
<PARAM NAME="SQL" VALUE="QueryText">
</OBJECT>
Remarques
ID de classe du RDS. L’objet dataControl est BD96C556-65A3-11D0-983A-00C04FC29E33.
Note
Si vous obtenez une erreur indiquant qu’un RDS. DataSpace ou RDS. DataControl objet ne charge pas, assurez-vous que vous utilisez l’ID de classe approprié. Les ID de classe pour ces objets ont changé de la version 1.0 et de la version 1.1. En outre, n’oubliez pas que même les colonnes nullables doivent être définies lorsque vous utilisez l’objet RDS DataControl.
Pour un scénario de base, vous devez définir uniquement les propriétés SQL, Connectet Server propriétés du service Bureau à distance . DataControl objet, qui appelle automatiquement l’objet métier par défaut, RDSServer.DataFactory.
Toutes les propriétés de la RDS. Les DataControl sont facultatives, car les objets métier personnalisés peuvent remplacer leurs fonctionnalités.
Note
Si vous interrogez plusieurs résultats, seul le premier jeu d’enregistrements est retourné. Si plusieurs jeux de résultats sont nécessaires, affectez chacun à sa propre DataControl. Voici un exemple de requête pour plusieurs résultats : "Select * from Authors, Select * from Topics"
Ajout de « DFMode=20 ; » à votre chaîne de connexion lorsque vous utilisez le RDS. L’objet dataControl peut améliorer les performances de votre serveur lorsque vous mettez à jour les données. Avec ce paramètre, l’objet RDSServer.DataFactory sur le serveur utilise un mode moins gourmand en ressources. Toutefois, les fonctionnalités suivantes ne sont pas disponibles dans cette configuration :
Utilisation de requêtes paramétrables.
Obtention des informations de paramètre ou de colonne avant d’appeler la méthode Execute.
Définition mises à jour Transact sur true.
Obtention de l’état de ligne.
Appel de la méthode de resync.
Actualisation (explicitement ou automatique) via la propriété Update Resync.
Définition propriétés commande ou Records et.
Utilisation de adCmdTableDirect.
The RDS. L’objet DataControl s’exécute en mode asynchrone par défaut. Si vous avez besoin d’une exécution synchrone pour votre application, définissez le paramètre ExecuteOptions égal à adcExecSync et le paramètre FetchOptions égal à adcFetchUpFront, comme illustré dans l’exemple suivant.
<OBJECT CLASSID="clsid:BD96C556-65A3-11D0-983A-00C04FC29E33"
ID="DataControl"
<PARAM NAME="Connect" VALUE="DSN=DSNName;UID=MyUserID;PWD=<password>;">
<PARAM NAME="Server" VALUE="https://awebsrvr">
<PARAM NAME="SQL" VALUE="QueryText">
<PARAM NAME="ExecuteOptions" VALUE="1"> <PARAM NAME="FetchOptions" VALUE="1">
</OBJECT>
Utilisez un RDS. DataControl objet pour lier les résultats d’une requête unique à un ou plusieurs contrôles visuels. Par exemple, supposons que vous codez une requête demandant des données client telles que Nom, Résidence, Lieu de naissance, Âge et État du client prioritaire. Vous pouvez utiliser un seul RDS. Objet DataControl pour afficher le nom, l’âge et la région d’un client dans trois zones de texte distinctes ; État du client prioritaire dans une case à cocher ; et toutes les données d’un contrôle de grille.
Utilisez différentes RDS. DataControl objets pour lier les résultats de plusieurs requêtes à différents contrôles visuels. Par exemple, supposons que vous utilisez une requête pour obtenir des informations sur un client et une deuxième requête pour obtenir des informations sur la marchandise que le client a achetées. Vous souhaitez afficher les résultats de la première requête dans trois zones de texte et une case à cocher, ainsi que les résultats de la deuxième requête dans un contrôle de grille. Si vous utilisez l’objet métier par défaut (RDSServer.DataFactory), vous devez effectuer les opérations suivantes :
Ajoutez deux RDS. DataControl objets sur votre page Web.
Écrivez deux requêtes, une pour chaque propriété SQL des deux RDS. Objets dataControl. Un RDS. L’objet dataControl contient une requête SQL demandant des informations client ; la deuxième contient une requête demandant une liste de marchandises achetée par le client.
Dans les balises OBJECT de chaque contrôle lié, spécifiez la valeur DATAFLD pour définir les valeurs des données que vous souhaitez afficher dans chaque contrôle visuel.
Il n’existe aucune restriction de nombre sur le nombre de services Bureau à distance . DataControl objets que vous pouvez incorporer à l’aide de balises OBJECT sur une seule page web.
Lorsque vous définissez le RDS. Objet DataControl sur une page Web, utilisez Height et Width valeurs telles que 1 (pour éviter l’inclusion d’espace supplémentaire).
Les composants clients du service de données distant sont déjà inclus dans Internet Explorer 4.0 ; Par conséquent, vous n’avez pas besoin d’inclure un paramètre CODEBASE dans votre RDS. Balise d’objet DataControl.
Avec Internet Explorer 4.0 ou version ultérieure, vous pouvez lier des données à l’aide de contrôles HTML et de contrôles ActiveX uniquement s’ils sont marqués comme contrôles de modèle d’appartement.
Note
Utilisateurs Microsoft Visual Basic Les services Bureau à distance . DataControl est sécurisé pour les scripts et est utilisé uniquement dans les applications web. Une application cliente Visual Basic n’a pas besoin de l’utiliser.
Cette section contient la rubrique suivante.