RDS-Programmierungsmodell im Detail

Gilt für: Access 2013, Office 2013

Die wichtigsten Elemente des RDS-Programmiermodells:

• RDS. DataSpace
• RDSServer.DataFactory
• RDS. DataControl
• Ereignis

RDS. DataSpace

Durch die Clientanwendung müssen der Server und das aufzurufende Serverprogramm angegeben werden. Dafür empfängt die Anwendung einen Verweis auf das Serverprogramm, und der Verweis kann von der Anwendung behandelt werden wie das Serverprogramm selbst.

Im RDS-Objektmodell wird diese Funktionalität durch das RDS.DataSpace-Objekt verkörpert.

Das Serverprogramm wird mit einem Programmbezeichner oder einer ProgID angegeben. Vom Server werden die ProgID und die Registrierung des Servercomputers zum Suchen von Informationen zu dem eigentlichen zu initiierenden Programm verwendet.

Die Unterscheidung erfolgt in RDS intern abhängig davon, ob sich das Serverprogramm auf einem Remoteserver im Internet oder Intranet, auf einem Server in einem lokalen Netzwerk oder überhaupt nicht auf einem Server, sondern in einer Dynamic Link Library (DLL) befindet. Durch diese Unterscheidung wird bestimmt, wie Informationen zwischen dem Client und dem Server ausgetauscht werden, und es werden deutlich andere Verweise an die Clientanwendung zurückgegeben. Aus Ihrer Sicht hat diese Unterscheidung jedoch keine besondere Bedeutung. Wichtig ist nur, dass Sie einen verwendbaren Programmverweis empfangen.

RDSServer.DataFactory

Durch RDS wird ein Standardserverprogramm bereitgestellt, mit dem eine SQL-Abfrage für die Datenquelle ausgeführt und ein Recordset-Objekt zurückgegeben oder ein Recordset-Objekt akzeptiert und die Datenquelle aktualisiert werden kann.

Im RDS-Objektmodell wird diese Funktionalität durch das RDSServer.DataFactory-Objekt verkörpert.

Darüber hinaus verfügt dieses Objekt über eine Methode zum Erstellen eines leeren Recordset-Objekts , das Sie programmgesteuert auffüllen können (CreateRecordset), und eine weitere Methode zum Konvertieren eines Recordset-Objekts in eine Textzeichenfolge zum Erstellen einer Webseite (ConvertToString).

Mit ADO können Sie einige standardmäßige Verbindungs- und Befehlsverhaltensweisen von RDSServer.DataFactory mit einem DataFactory -Handler und einer Anpassungsdatei, die Verbindungs-, Befehls- und Sicherheitsparameter enthält, außer Kraft setzen.

Das Serverprogramm wird manchmal als Geschäftsobjekt bezeichnet. Sie können Ein eigenes benutzerdefiniertes Geschäftsobjekt schreiben, das komplizierte Datenzugriffe, Gültigkeitsprüfungen usw. durchführen kann. Auch beim Schreiben eines benutzerdefinierten Geschäftsobjekts können Sie eine Instanz eines RDSServer.DataFactory-Objekts erstellen und einige seiner Methoden verwenden, um Ihre eigenen Aufgaben auszuführen.

RDS. DataControl

Durch RDS wird eine Möglichkeit bereitgestellt, die Funktionalität von RDS.DataSpace und RDSServer.DataFactory zu kombinieren und außerdem die einfache Verwendung des durch eine Abfrage aus einer Datenquelle zurückgegebenen Recordset -Objekts durch visuelle Steuerelemente zu ermöglichen. Für den häufigsten Fall wird versucht, so weit wie möglich automatisch Zugriff auf Informationen auf einem Server zu erhalten und diese in einem visuellen Steuerelement anzuzeigen.

Im RDS-Objektmodell wird diese Funktionalität durch das RDS.DataControl-Objekt verkörpert.

Das RDS.DataControl -Objekt hat zwei Aspekte. Ein Aspekt bezieht sich auf die Datenquelle. Wenn Sie die Befehls- und Verbindungsinformationen mithilfe der Eigenschaften Connect und SQL von RDS.DataControl festlegen, wird automatisch RDS.DataSpace zum Erstellen eines Verweises auf das standardmäßige RDSServer.DataFactory -Objekt verwendet. Dann wird von RDSServer.DataFactory der Wert der Connect -Eigenschaft zum Herstellen einer Verbindung mit der Datenquelle verwendet, mithilfe des Werts der SQL -Eigenschaft ein Recordset -Objekt aus der Datenquelle abgerufen und das Recordset -Objekt an RDS.DataControl zurückgegeben.

Der zweite Aspekt bezieht sich auf die Anzeige zurückgegebener Recordset-Informationen in einem visuellen Steuerelement. Sie können dem RDS ein visuelles Steuerelement zuordnen . DataControl (in einem Prozess, der als Bindung bezeichnet wird) und erhalten Zugriff auf die Informationen im zugeordneten Recordset-Objekt , das Abfrageergebnisse auf einer Webseite in Microsoft Internet Explorer anzeigt. Durch jedes RDS.DataControl-Objekt wird ein Recordset-Objekt, das die Ergebnisse einer einzelnen Abfrage darstellt, an mindestens ein visuelles Steuerelement gebunden (z. B. ein Textfeld, Kombinationsfeld, Rastersteuerelement usw.). Auf jeder Seite kann mehr als ein RDS.DataControl-Objekt vorhanden sein. Jedes RDS.DataControl-Objekt kann mit einer anderen Datenquelle verbunden sein und die Ergebnisse einer separaten Abfrage enthalten.

Das RDS.DataControl -Objekt verfügt außerdem über eigene Methoden für das Navigieren, Sortieren und Filtern der Zeilen des zugeordneten Recordset -Objekts. Diese Methoden sind vergleichbar, jedoch nicht identisch mit den Methoden des Recordset-ADO-Objekts.

Ereignisse

Von RDS werden zwei eigene Ereignisse unterstützt, die vom ADO-Ereignismodell unabhängig sind. Das onReadyStateChange-Ereignis wird aufgerufen, wenn die ReadyState-Eigenschaft des RDS.DataControl -Objekts geändert wird, sodass Sie benachrichtigt werden, wenn eine asynchrone Operation erfolgreich abgeschlossen oder beendet wurde oder wenn bei dieser ein Fehler aufgetreten ist. Das onError-Ereignis wird bei jedem Auftreten eines Fehlers aufgerufen, selbst wenn der Fehler während einer asynchronen Operation auftritt.