ConnectionString-Eigenschaft (ADO)
Gibt die Informationen an, mithilfe derer eine Verbindung mit einer Datenquelle hergestellt wird.
Einstellungen und Rückgabewerte
Legt einen String-Wert fest oder gibt ihn zurück.
Hinweise
Verwenden Sie die ConnectionString-Eigenschaft, um eine Datenquelle anzugeben, indem Sie eine detaillierte Verbindungszeichenfolge übergeben, die eine Reihe von Argument = Wertanweisungen enthält, die durch Semikolons getrennt sind.
ActiveX Data Objects (ADO) unterstützt fünf Argumente für die ConnectionString-Eigenschaft. Alle anderen Argumente werden ohne Verarbeitung durch ADO direkt an den Anbieter übergeben. ADO unterstützt die folgenden Argumente.
| Argument | Beschreibung |
|---|---|
| Provider= | Gibt den Namen eines Anbieters an, der für die Verbindung verwendet werden soll. |
| File Name= | Gibt den Namen einer anbieterspezifischen Datei (z. B. ein persistiertes Datenquellenobjekt) an, die vordefinierte Verbindungsinformationen enthält. |
| Remote Provider= | Gibt den Namen eines Anbieters an, der beim Öffnen einer clientseitigen Verbindung verwendet werden soll. (Nur Remotedatendienst.) |
| Remote Server= | Gibt den Pfadnamen des Servers an, der beim Öffnen einer clientseitigen Verbindung verwendet werden soll. (Nur Remotedatendienst.) |
| URL= | Gibt die Verbindungszeichenfolge als absolute URL an, die eine Ressource identifiziert (z. B. eine Datei oder ein Verzeichnis). |
Nachdem Sie die ConnectionString-Eigenschaft festgelegt und das Connection-Objekt geöffnet haben, kann der Anbieter den Inhalt der Eigenschaft ändern, z. B. durch Zuordnen der ADO-definierten Argumentnamen zu ihren Entsprechungen für den jeweiligen Anbieter.
Die ConnectionString-Eigenschaft erbt automatisch den Wert, der für das ConnectionString-Argument der Open-Methode verwendet wird. Sie können die aktuelle ConnectionString-Eigenschaft daher während des Aufrufs der Open-Methode überschreiben.
Da das Argument File Name ADO veranlasst, den zugeordneten Anbieter zu laden, können Sie nicht sowohl das Argument Provider als auch das Argument File Name übergeben.
Auf die ConnectionString-Eigenschaft besteht Lese- und Schreibzugriff, wenn die Verbindung geschlossen ist. Wenn die Verbindung geöffnet ist, ist sie schreibgeschützt.
Duplikate eines Arguments in der ConnectionString-Eigenschaft werden ignoriert. Die letzte Instanz eines Arguments wird verwendet.
Hinweis
Verwendung mit dem Remotedatendienst: Bei der Verwendung für ein clientseitiges Connection-Objekt kann die ConnectionString-Eigenschaft nur die Parameter Remote Provider und Remote Server enthalten.
In der folgenden Tabelle sind die ADO-Standardanbieter für die einzelnen Windows-Betriebssysteme aufgeführt:
| ADO-Standardanbieter | Windows-Betriebssystem |
|---|---|
| MSDASQL (Geben Sie den Anbieternamen in der Verbindungszeichenfolge explizit an, um die Lesbarkeit des Quellcodes zu verbessern.) |
Windows 2000 (32-Bit) Windows XP (32-Bit) Windows 2003 Server (32-Bit) Windows Vista (32-Bit) Windows Vista Service Pack 1 oder höher (32-Bit und 64-Bit) Windows-Versionen nach Windows Vista (32-Bit und 64-Bit) |
| Keine Standardeinstellung. Wenn eine ADO-Anwendung auf den folgenden Betriebssystemen ausgeführt wird und den Anbieter nicht explizit angibt, gibt ADO den folgenden Fehler zurück: „ADODB.Connection: Ein Provider ist nicht angegeben, und es gibt keinen Standardprovider.“ |
Windows 2000 (64-Bit) Windows XP (64-Bit) Windows 2003 Server (64-Bit) Windows Vista (64-Bit) |
Gilt für
Weitere Informationen
Beispiel für die Eigenschaften ConnectionString, ConnectionTimeout und State (VB)
Beispiel für die Eigenschaften ConnectionString, ConnectionTimeout und State (VC++)
Anhang A: Daten und Dienstanbieter