OdbcConnection.ConnectionString Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Dient zum Abrufen oder Festlegen der Zeichenfolge, die zum Öffnen einer Datenquelle verwendet wird.
public:
virtual property System::String ^ ConnectionString { System::String ^ get(); void set(System::String ^ value); };public:
property System::String ^ ConnectionString { System::String ^ get(); void set(System::String ^ value); };public override string ConnectionString { get; set; }public string ConnectionString { get; set; }[System.ComponentModel.SettingsBindable(true)]
public override string ConnectionString { get; set; }member this.ConnectionString : string with get, set[<System.ComponentModel.SettingsBindable(true)>]
member this.ConnectionString : string with get, setPublic Overrides Property ConnectionString As StringPublic Property ConnectionString As StringEigenschaftswert
Die VERBINDUNGSzeichenfolge des ODBC-Treibers, die Einstellungen enthält, z. B. den Datenquellennamen, die zum Herstellen der anfänglichen Verbindung erforderlich sind. Der Standardwert ist eine leere Zeichenfolge (""). Die Höchstlänge beträgt 1024 Zeichen.
Implementiert
- Attribute
Hinweise
Die ConnectionString Eigenschaft ist so konzipiert, dass das ODBC-Verbindungszeichenfolgenformat so genau wie möglich übereinstimmt. Die ConnectionString Kann nur festgelegt werden, wenn die Verbindung geschlossen wird, und sobald sie festgelegt wird, wird sie unverändert an den Treiber-Manager und den zugrunde liegenden Treiber übergeben. Daher muss die Syntax für die ConnectionString genau mit dem Treiber-Manager und der zugrunde liegenden Treiberunterstützung übereinstimmen.
Sie können die ConnectionString Eigenschaft verwenden, um eine Verbindung mit einer Vielzahl von Datenquellen herzustellen. Dazu gehört ein ODBC-Datenquellenname (DSN). 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 das Persist Security Info Schlüsselwort, das von anderen .NET Framework-Datenanbietern unterstützt wird.
ConnectionString Die Eigenschaft verhält sich jedoch so, als ob Persist Security Info sie festgelegt falsewäre. 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 objekt gelesen wird, das geöffnet wurde, wird die Verbindungszeichenfolge abzüglich des Kennworts zurückgegeben. Sie können dieses Verhalten nicht ändern; Wenn die Anwendung das Kennwort benötigt, speichern Sie es daher separat vor dem 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, außer wenn ein Fehler erkannt wird. In diesem Fall werden keine der Eigenschaften aktualisiert.
OdbcConnection Eigenschaften (z Database. B. ) geben nur Standardeinstellungen oder die in der ConnectionStringDatei angegebenen Einstellungen zurück.
Einige grundlegende Überprüfung der Verbindungszeichenfolge erfolgt, sobald Sie die ConnectionString Eigenschaft festlegen. Zu diesem Zeitpunkt überprüft der Datenanbieter, ob die Verbindungszeichenfolge den Wert "keyword=value;..." erfüllt. formatieren, aber nicht überprüfen, ob Schlüsselwörter oder Werte gültig sind. Die verbleibende Überprüfung wird vom zugrunde liegenden ODBC-Treiber ausgeführt, wenn die Anwendung die Open Methode aufruft.
Eine ODBC-Verbindungszeichenfolge weist die folgende Syntax auf:
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
wenn character-string null oder mehr Zeichen vorhanden sind; identifier mindestens ein Zeichen vorhanden ist, attribute-keyword wird die Groß-/Kleinschreibung nicht beachtet; attribute-value die Groß-/Kleinschreibung kann beachtet werden; und der Wert des DSN-Schlüsselworts besteht nicht nur aus Leerzeichen.
Aufgrund der Grammatik der Verbindungszeichenfolge und der Initialisierungsdatei sollten Schlüsselwörter und Attributwerte vermieden werden, die die Zeichen []{}(),;enthalten? *=!@ nicht in geschweifte Klammern eingeschlossen. Der Wert des DSN-Schlüsselworts darf nicht nur aus Leerzeichen bestehen und darf keine führenden Leerzeichen enthalten. Aufgrund der Grammatik der Systeminformationen können Schlüsselwörter und Datenquellennamen nicht das umgekehrte Schrägstrichzeichen (\) enthalten.
Anwendungen müssen nach dem Schlüsselwort Driver keine geschweiften Klammern um den Attributwert hinzufügen, es sei denn, das Attribut enthält ein Semikolon (;), in diesem Fall sind die geschweiften Klammern erforderlich. Wenn der vom Treiber empfangene Attributwert geschweifte Klammern enthält, sollte der Treiber sie nicht entfernen, sondern Teil der zurückgegebenen Verbindungszeichenfolge sein.
Ein DSN- oder Verbindungszeichenfolgenwert, der in geschweifte Klammern ({}) eingeschlossen ist, die eines der Zeichen []{}(),;? *=!@ wird an den Treiber übergeben. Wenn Sie diese Zeichen jedoch in einem Schlüsselwort verwenden, gibt der Treiber-Manager beim Arbeiten mit Datei-DSNs einen Fehler zurück, übergibt jedoch die Verbindungszeichenfolge für normale Verbindungszeichenfolgen an den Treiber. Vermeiden Sie die Verwendung eingebetteter geschweifter Klammern in einem Schlüsselwortwert.
Die Verbindungszeichenfolge kann eine beliebige Anzahl treiberdefinierter Schlüsselwörter enthalten. Da das DRIVER-Schlüsselwort 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, wobei nur die Informationen in der Verbindungszeichenfolge verwendet werden. Der Treiber definiert, welche Schlüsselwörter zum Herstellen einer Verbindung mit der Datenquelle erforderlich sind.
Wenn Schlüsselwörter in der Verbindungszeichenfolge wiederholt werden, gibt es keine Garantie, welcher Wert ausgewählt wird.
Hinweis
Wenn ein ODBC-Treiber Verbindungszeichenfolgen mit mehr als 1024 Zeichen unterstützt, können Sie einen Datenquellennamen (Data Source Name, DSN) verwenden, um die maximale Längenbeschränkung zu überschreiten.
