Microsoft OLE DB-Remotinganbieter – Übersicht
Der Microsoft OLE DB-Remotinganbieter ermöglicht lokalen Benutzer*innen auf einem Clientcomputer das Aufrufen von Datenanbietern auf einem Remotecomputer. Geben Sie die Datenanbieterparameter für den Remotecomputer an, wie Sie es als lokale*r Benutzer*in auf dem Remotecomputer tun würden. Geben Sie dann die Parameter an, die vom Remotinganbieter für den Zugriff auf den Remotecomputer verwendet werden. Anschließend können Sie auf den Remotecomputer wie ein*e lokale*r Benutzer*in zugreifen.
Wichtig
Ab Windows 8 und Windows Server 2012 sind RDS-Serverkomponenten nicht mehr im Windows-Betriebssystem enthalten (weitere Informationen finden Sie in den jeweiligen Kompatibilitäts-Cookbooks zu Windows 8 und Windows Server 2012). RDS-Clientkomponenten werden in einer zukünftigen Version von Windows entfernt. Nutzen Sie diese Funktionen bei Neuentwicklungen nicht mehr, und planen Sie die Änderung von Anwendungen, die diese Funktion zurzeit verwenden. Anwendungen, die RDS verwenden, sollten zu WCF Data Service migriert werden.
Anbieterschlüsselwort
Um den OLE DB-Remotinganbieter aufzurufen, geben Sie das folgende Schlüsselwort und den folgenden Wert in der Verbindungszeichenfolge an. (Beachten Sie den Leerraum im Anbieternamen.)
"Provider=MS Remote"
Zusätzliche Schlüsselwörter
Wenn dieser Dienstanbieter aufgerufen wird, sind die folgenden zusätzlichen Schlüsselwörter relevant.
| Schlüsselwort | Beschreibung |
|---|---|
| Datenquelle | Gibt den Namen der Remotedatenquelle an. Es wird zur Verarbeitung an den OLE DB-Remotinganbieter übergeben. Dieses Schlüsselwort entspricht der Connect-Eigenschaft des RDS.DataControl-Objekts. |
Dynamische Eigenschaften
Wenn dieser Dienstanbieter aufgerufen wird, werden die folgenden dynamischen Eigenschaften der Properties-Sammlung des Connection-Objekts hinzugefügt.
| Name der dynamischen Eigenschaft | Beschreibung |
|---|---|
| DFMode | Gibt den DataFactory-Modus an. Eine Zeichenfolge, die die gewünschte Version des DataFactory-Objekts auf dem Server angibt. Legen Sie diese Eigenschaft fest, bevor Sie eine Verbindung öffnen, um eine bestimmte Version des DataFactory-Objekts anzufordern. Wenn die angeforderte Version nicht verfügbar ist, wird versucht, die vorherige Version zu verwenden. Wenn keine vorherige Version vorhanden ist, tritt ein Fehler auf. Wenn DFMode kleiner als die verfügbare Version ist, tritt ein Fehler auf. Diese Eigenschaft ist schreibgeschützt, nachdem eine Verbindung hergestellt wurde. Sie kann einen der folgenden gültigen Zeichenfolgenwerte haben: - „25“-Version 2.5 (Standard) - „21“-Version 2.1 - „20“-Version 2.0 - „15“-Version 1.5 |
| Command Properties | Gibt Werte an, die der Zeichenfolge der Befehls- bzw. Rowset-Eigenschaften hinzugefügt werden, die vom MS-Remoteanbieter an den Server gesendet werden. Der Standardwert für diese Zeichenfolge ist „vt_empty“. |
| Current DFMode | Gibt die tatsächliche Versionsnummer von DataFactory auf dem Server an. Überprüfen Sie diese Eigenschaft, um zu sehen, ob die in der DFMode-Eigenschaft angeforderte Version berücksichtigt wurde. Kann einer der folgenden gültigen ganzzahligen Long-Werte sein: - 25-Version 2.5 (Standard) - 21-Version 2.1 - 20-Version 2.0 - 15-Version 1.5 Das Hinzufügen von „DFMode=20“ zu Ihrer Verbindungszeichenfolge beim Verwenden des MSRemote-Anbieters kann die Leistung Ihres Servers beim Aktualisieren von Daten verbessern. Mit dieser Einstellung verwendet das RDSServer.DataFactory-Objekt auf dem Server einen weniger ressourcenintensiven Modus. Die folgenden Features sind in dieser Konfiguration jedoch nicht verfügbar: - Verwenden parametrisierter Abfragen. - Abrufen von Parameter- oder Spalteninformationen vor dem Aufrufen der Execute-Methode. - Festlegen von Transact Updates auf True. - Abrufen des Zeilenstatus. - Aufrufen der Resync-Methode. - Aktualisieren (explizit oder automatisch) über die Update Resync-Eigenschaft. - Festlegen von Command- oder Recordset-Eigenschaften. - Verwenden von adCmdTableDirect. |
| Handler | Gibt den Namen eines serverseitigen Anpassungsprogramms (Handler) an, das die Funktionalität von RDSServer.DataFactory und aller vom Handler verwendeten durch Kommas (,) getrennten Parameter erweitert. Ein String-Wert. |
| Internet Timeout | Gibt die maximale Anzahl von Millisekunden an, die für die Übertragung einer Anforderung zum bzw. vom Server gewartet wird. (Der Standard ist 5 Minuten.) |
| Remote Provider | Gibt den Namen des Datenanbieters an, der auf dem Remoteserver verwendet werden soll. |
| Remote Server | Gibt den Servernamen und das Kommunikationsprotokoll an, der bzw. das von dieser Verbindung verwendet werden soll. Diese Eigenschaft entspricht der Server-Eigenschaft des RDS.DataControl-Objekts. |
| Transact Updates | Wenn dieser Wert auf True festgelegt ist, gibt er an, dass UpdateBatch bei der Ausführung auf dem Server innerhalb einer Transaktion ausgeführt wird. Der Standardwert für diese boolesche dynamische Eigenschaft ist False. |
Sie können auch beschreibbare dynamische Eigenschaften festlegen, indem Sie ihre Namen als Schlüsselwörter in der Verbindungszeichenfolge angeben. Legen Sie beispielsweise die dynamische Internet Timeout-Eigenschaft auf fünf Sekunden fest, indem Sie Folgendes angeben:
Dim cn as New ADODB.Connection
cn.Open "Provider=MS Remote;Internet Timeout=5000"
Sie können eine dynamische Eigenschaft auch festlegen oder abrufen, indem Sie ihren Namen als Index für die Properties-Sammlung angeben. Im folgenden Beispiel wird gezeigt, wie Sie den aktuellen Wert der dynamischen Internet Timeout-Eigenschaft abrufen und ausgeben und dann einen neuen Wert festlegen:
Debug.Print cn.Properties("Internet Timeout")
cn.Properties("Internet Timeout") = 5000
Hinweise
In ADO 2.0 konnte der OLE DB-Remotinganbieter nur im ActiveConnection-Parameter der Open-Methode desRecordset-Objekts angegeben werden. Ab ADO 2.1 kann der Anbieter auch im ConnectionString-Parameter der Open-Methode des Connection-Objekts angegeben werden.
Das Äquivalent der SQL-Eigenschaft des RDS.DataControl-Objekts ist nicht verfügbar. Stattdessen wird das Source-Argument der Open-Methode des Recordset-Objekts verwendet.
Hinweis Durch Angabe von „...;Remote Provider=MS Remote;...“ würde ein Szenario mit vier Ebenen erstellt. Szenarien, die über drei Ebenen hinausgehen, wurden nicht getestet und sollten nicht benötigt werden.
Beispiel
In diesem Beispiel wird eine Abfrage für die Authors-Tabelle der Pubs-Datenbank auf einem Server mit dem Namen YourServer ausgeführt. Die Namen der Remotedatenquelle und des Remoteservers werden in der Open-Methode des Connection-Objekts bereitgestellt, und die SQL-Abfrage wird in der Open-Methode des Recordset-Objekts angegeben. Ein Recordset-Objekt wird zurückgegeben, bearbeitet und verwendet, um die Datenquelle zu aktualisieren.
Dim rs as New ADODB.Recordset
Dim cn as New ADODB.Connection
cn.Open "Provider=MS Remote;Data Source=pubs;" & _
"Remote Server=https://YourServer"
rs.Open "SELECT * FROM authors", cn
... 'Edit the recordset
rs.UpdateBatch 'Equivalent of RDS SubmitChanges
...
Weitere Informationen
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für