OdbcConnection.ConnectionString Eigenschaft

Definition

Namespace:

System.Data.Odbc

Assembly:

System.Data.Odbc.dll

Paket:

System.Data.Odbc v8.0.0

Quelle:

OdbcConnection.cs

Ruft die Zeichenfolge zum Öffnen einer Datenquelle ab oder legt diese fest.

public:
 virtual property System::String ^ ConnectionString { System::String ^ get(); void set(System::String ^ value); };

public override string ConnectionString { get; set; }

member this.ConnectionString : string with get, set

Public Overrides Property ConnectionString As String

Eigenschaftswert

String

Die Verbindungszeichenfolge für ODBC-Treiber mit den erforderlichen Einstellungen zum erstmaligen Herstellen der Verbindung (z. B. dem Namen der Datenquelle). Der Standardwert ist eine leere Zeichenfolge (""). Die maximale Länge beträgt 1024 Zeichen.

Hinweise

Die ConnectionString -Eigenschaft ist so konzipiert, dass das ODBC-Verbindungszeichenfolge-Format so eng wie möglich übereinstimmt. Kann ConnectionString nur festgelegt werden, wenn die Verbindung geschlossen wird, und sobald sie festgelegt ist, wird es unverändert an den Treiber-Manager und den zugrunde liegenden Treiber übergeben. Daher muss die Syntax für genau dem ConnectionString entsprechen, was vom Treiber-Manager und dem zugrunde liegenden Treiber unterstützt wird.

Sie können die ConnectionString -Eigenschaft verwenden, um eine Verbindung mit einer Vielzahl von Datenquellen herzustellen. Dies schließt einen ODBC-Datenquellennamen (DSN) ein. Im folgenden Beispiel werden mehrere mögliche Verbindungszeichenfolgen veranschaulicht.

"Driver={SQL Server};Server=(local);Trusted_Connection=Yes;Database=AdventureWorks;"

"Driver={Microsoft ODBC for Oracle};Server=ORACLE8i7;Persist Security Info=False;Trusted_Connection=Yes"

"Driver={Microsoft Access Driver (*.mdb)};DBQ=c:\bin\Northwind.mdb"

"Driver={Microsoft Excel Driver (*.xls)};DBQ=c:\bin\book1.xls"

"Driver={Microsoft Text Driver (*.txt; *.csv)};DBQ=c:\bin"

"DSN=dsnname"

Hinweis

Der .NET Framework-Datenanbieter für ODBC unterstützt nicht die Schlüsselwort (keyword), die Persist Security Info von anderen .NET Framework Datenanbietern unterstützt wird. Die -Eigenschaft verhält sich jedoch so, ConnectionString als wäre Persist Security Info auf falsefestgelegt. Dies bedeutet, dass Sie das Kennwort nicht aus der ConnectionString Eigenschaft abrufen können, wenn die Verbindung geöffnet wurde. Wenn die ConnectionString Eigenschaft aus einem OdbcConnection geöffneten Objekt gelesen wird, wird die Verbindungszeichenfolge abzüglich des Kennworts zurückgegeben. Sie können dieses Verhalten nicht ändern. Wenn die Anwendung das Kennwort erfordert, speichern Sie es daher separat, bevor Sie aufrufen Open.

Viele der in der Zeichenfolge angegebenen Einstellungen verfügen über entsprechende schreibgeschützte Eigenschaften (z. Server=(local)B. , die der DataSource -Eigenschaft entspricht). Diese Eigenschaften werden aktualisiert, nachdem die Verbindung geöffnet wurde, es sei denn, es wird ein Fehler erkannt. In diesem Fall wird keine der Eigenschaften aktualisiert. OdbcConnection Eigenschaften (z Database. B. ) geben nur Standardeinstellungen oder die in ConnectionStringangegebenen Einstellungen zurück.

In Microsoft .NET Framework Version 1.0 erfolgt die Überprüfung der Verbindungszeichenfolge erst, wenn eine Anwendung die Open -Methode aufruft. Es liegt in der Verantwortung des zugrunde liegenden ODBC-Treibers, den Verbindungszeichenfolge zu überprüfen. Wenn die Verbindungszeichenfolge ungültige oder nicht unterstützte Eigenschaften enthält, kann der Treiber zur Laufzeit eine OdbcException auslösen.

In der .NET Framework Version 1.1 und höher erfolgt jedoch eine grundlegende Überprüfung des Verbindungszeichenfolge, sobald Sie die ConnectionString Eigenschaft festlegen. Zu diesem Zeitpunkt überprüft der Datenanbieter, ob der Verbindungszeichenfolge die "Schlüsselwort (keyword)=wert;..." erfüllt. formatieren, aber es wird nicht überprüft, ob Schlüsselwörter oder Werte gültig sind. Die verbleibende Überprüfung wird vom zugrunde liegenden ODBC-Treiber durchgeführt, wenn die Anwendung die Open -Methode aufruft.

Ein ODBC-Verbindungszeichenfolge verfügt über die folgende Syntax:

connection-string ::= empty-string[;] | attribute[;] | attribute; connection-string
empty-string ::=
attribute ::= attribute-keyword=attribute-value | DRIVER=[{]attribute-value[}]
attribute-keyword ::= DSN | UID | PWD
 | driver-defined-attribute-keyword
attribute-value ::= character-string
driver-defined-attribute-keyword ::= identifier

wobei character-string null oder mehr Zeichen enthält, identifier ein oder mehrere Zeichen aufweist, attribute-keyword die Groß-/Kleinschreibung nicht beachtet wird, attribute-value und der Wert des DSN-Schlüsselwort (keyword) nicht nur aus Leerzeichen besteht.

Aufgrund der Grammatik der Verbindungszeichenfolge- und Initialisierungsdatei sollten Schlüsselwörter und Attributwerte vermieden werden, die die Zeichen []{}(),;? *=!@ nicht mit Klammern eingeschlossen. Der Wert des DSN-Schlüsselwort (keyword) darf nicht nur aus Leerzeichen bestehen und sollte keine führenden Leerzeichen enthalten. Aufgrund der Grammatik der Systeminformationen können Schlüsselwörter und Datenquellennamen den umgekehrten Schrägstrich (\) nicht enthalten.

Anwendungen müssen nach dem Treiber Schlüsselwort (keyword) keine Klammern um den Attributwert hinzufügen, es sei denn, das Attribut enthält ein Semikolon (;), in diesem Fall sind die Klammern erforderlich. Wenn der Attributwert, den der Treiber empfängt, Klammern enthält, sollte der Treiber diese nicht entfernen, sondern Teil der zurückgegebenen Verbindungszeichenfolge sein.

Ein DSN oder Verbindungszeichenfolge Wert, der mit Klammern ({}) eingeschlossen ist, die eines der Zeichen []{}(),;enthält? *=!@ wird intakt an den Treiber übergeben. Wenn Sie diese Zeichen jedoch in einer Schlüsselwort (keyword) verwenden, gibt der Treiber-Manager beim Arbeiten mit Datei-DSNs einen Fehler zurück, übergibt jedoch die Verbindungszeichenfolge für reguläre Verbindungszeichenfolgen an den Treiber. Vermeiden Sie die Verwendung eingebetteter Klammern in einem Schlüsselwort (keyword) Wert.

Die Verbindungszeichenfolge kann eine beliebige Anzahl von vom Treiber definierten Schlüsselwörtern enthalten. Da der DRIVER-Schlüsselwort (keyword) keine Informationen aus dem System verwendet, muss der Treiber genügend Schlüsselwörter definieren, damit ein Treiber eine Verbindung mit einer Datenquelle herstellen kann, die nur die Informationen im Verbindungszeichenfolge verwendet. Der Treiber definiert, welche Schlüsselwörter erforderlich sind, um eine Verbindung mit der Datenquelle herzustellen.

Wenn Schlüsselwörter im Verbindungszeichenfolge wiederholt werden, gibt es keine Garantie, welcher Wert ausgewählt wird.

Hinweis

Wenn ein ODBC-Treiber Verbindungszeichenfolgen unterstützt, die länger als 1024 Zeichen sind, können Sie einen Datenquellennamen (Data Source Name, DSN) verwenden, um die maximale Längenbegrenzung zu überschreiten.

Weitere Informationen

• Herstellen einer Verbindung mit Datenquellen