Modèle de programmation RDS en détail

S’applique à : Access 2013, Office 2013

La liste ci-dessous répertorie les éléments-clés du modèle de programmation RDS :

• RDS. DataSpace
• RDSServer.DataFactory
• RDS. DataControl
• Événement

RDS. DataSpace

Votre application cliente doit spécifier le serveur et le programme serveur à appeler. En retour, votre application reçoit une référence au programme serveur et est en mesure de traiter la référence comme s'il s'agissait du programme serveur lui-même.

Le modèle objet RDS fournit cette fonctionnalité grâce à l'objet RDS.DataSpace.

Le programme serveur est spécifié au moyen d'un identificateur de programme ou ProgID. Le serveur utilise ce ProgID ainsi que le Registre du serveur pour localiser les informations relatives au programme à exécuter.

RdS fait une distinction en interne selon que le programme serveur se trouve sur un serveur distant sur Internet ou sur un intranet ; un serveur sur un réseau local ; ou pas du tout sur un serveur, mais plutôt sur une bibliothèque de liens dynamiques (DLL) locale. Cette distinction détermine la façon dont les informations sont échangées entre le client et le serveur, et fait une différence tangible dans le type de référence retourné à votre application cliente. Toutefois, de votre point de vue, cette distinction n’a pas de signification particulière. Tout ce qui importe, c’est que vous receviez une référence de programme utilisable.

RDSServer.DataFactory

RDS fournit un programme serveur par défaut capable d’exécuter des requêtes SQL sur la source de données et de retourner un objet Recordset ou de prendre un objet Recordset et de mettre à jour la source de données.

Le modèle objet RDS fournit cette fonctionnalité grâce à l'objet RDSServer.DataFactory.

En outre, cet objet a une méthode pour créer un objet Recordset vide que vous pouvez remplir par programme (CreateRecordset) et une autre méthode pour convertir un objet Recordset en chaîne de texte afin de générer une page web (ConvertToString).

ADO vous permet de remplacer une partie du comportement de commande et de connexion standard de RDSServer.DataFactory grâce à un gestionnaire DataFactory et à un fichier de personnalisation qui contient les paramètres de connexion, de commande et de sécurité.

Le programme serveur est parfois appelé objet métier. Vous pouvez écrire un objet métier pour effectuer des opérations plus complexes d'accès aux données, des contrôles de validité, etc. Même si vous écrivez votre propre objet métier, vous pouvez créer une instance d'un objet RDSServer.DataFactory et utiliser certaines de ses méthodes pour réaliser vos propres tâches.

RDS. DataControl

RDS offre la possibilité de combiner les fonctionnalités de RDS.DataSpace et de RDSServer.DataFactory et permet aux contrôles visuels d'utiliser facilement l'objet Recordset retourné par une requête exécutée sur une source de données. Dans la plupart des cas, RDS tente d'accéder automatiquement aux informations sur le serveur et de les afficher dans un contrôle visuel.

Le modèle objet RDS fournit ces fonctionnalités grâce à l'objet RDS.DataControl.

L'objet RDS.DataControl présente deux aspects. Le premier porte sur la source de données. Si vous définissez les informations de connexion et de commande à l'aide des propriétés Connect et SQL de l'objet RDS.DataControl, la source de données utilise automatiquement l'objet RDS.DataSpace pour créer une référence à l'objet RDSServer.DataFactory par défaut. Puis, l'objet RDSServer.DataFactory utilise la valeur de la propriété Connect pour établir la connexion à la source de données et la valeur de la propriété SQL pour obtenir un objet Recordset à partir de la source de données et retourne l'objet Recordset à l'objet RDS.DataControl.

Le second aspect porte sur l'affichage des informations de l'objet Recordset retournées dans un contrôle visuel. Vous pouvez associer un contrôle visuel au service Bureau à distance. DataControl (dans un processus appelé liaison) et accéder aux informations de l’objet Recordset associé, en affichant les résultats de la requête sur une page web dans Microsoft Internet Explorer. Chaque objet RDS.DataControl lie un objet Recordset, représentant les résultats d'une seule requête, à un ou plusieurs contrôles visuels (par exemple, une zone de texte, une zone de liste déroulante, un contrôle Grid, etc.). Une page peut comporter plusieurs objets RDS.DataControl. Chaque objet RDS.DataControl peut être connecté à une source de données différente et contenir les résultats d'une requête distincte.

L'objet RDS.DataControl comporte ses propres méthodes de navigation, de tri et de filtrage des lignes de l'objet Recordset associé. Ces méthodes, bien que similaires à celles de l'objet Recordset ADO, présentent quelques différences.

Événements

RDS prend en charge deux événements qui lui sont propres et indépendants du modèle d'événement ADO. L'événement onReadyStateChange est appelé chaque fois que la propriété ReadyState de l'objet RDS.DataControl change, vous avertissant ainsi de la réussite, de l'interruption ou d'une erreur d'exécution d'une opération asynchrone. L'événement onError est appelé chaque fois qu'une erreur se produit, même si l'erreur se produit au cours d'une opération asynchrone.