OracleConnection.ConnectionString Eigenschaft

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

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

public string ConnectionString { get; set; }

public override 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, set

Public Property ConnectionString As String

Public Overrides Property ConnectionString As String

Eigenschaftswert

Die Oracle-Verbindungszeichenfolge, die Einstellungen enthält, z. B. den Servernamen, erforderlich, um die anfängliche Verbindung herzustellen. Der Standardwert ist eine leere Zeichenfolge ("").

Implementiert

Attribute

SettingsBindableAttribute

Hinweise

Dies ConnectionString kann nur festgelegt werden, wenn die Verbindung geschlossen wird.

Sie können die ConnectionString Eigenschaft verwenden, um eine Verbindung mit einer Datenbank herzustellen.

Viele der in der Zeichenfolge angegebenen Einstellungen verfügen über entsprechende schreibgeschützte Eigenschaften (z Data Source=MyServer. B. , die der DataSource Eigenschaft entspricht). Wenn die Verbindungszeichenfolge festgelegt ist, werden alle diese Eigenschaften aktualisiert, es sei denn, ein Fehler wird erkannt, in diesem Fall werden keine der Eigenschaften aktualisiert. OracleConnection Eigenschaften geben nur Die Standardeinstellungen oder die in der ConnectionStringDatei angegebenen Einstellungen zurück.

Durch das Zurücksetzen einer ConnectionString geschlossenen Verbindung werden alle Verbindungszeichenfolgenwerte (und verwandte Eigenschaften) zurückgesetzt, einschließlich des Kennworts.

Die Verbindungszeichenfolge wird unmittelbar nach dem Festlegen analysiert. Wenn durch die Analyse Fehler in der Syntax angezeigt werden, wird eine Laufzeitausnahme generiert, z ArgumentException. B. Andere Fehler können nur gefunden werden, wenn versucht wird, die Verbindung zu öffnen.

Das grundlegende Format einer Verbindungszeichenfolge ist eine Reihe von Schlüsselwort-Wert-Paaren, die durch Semikolons getrennt sind. Das Gleichheitszeichen (=) verbindet jedes Schlüsselwort und seinen Wert. Um Werte einzuschließen, die ein Semikolon, ein einfaches Anführungszeichen oder ein doppeltes Anführungszeichen enthalten, muss der Wert in doppelte Anführungszeichen eingeschlossen werden. Wenn der Wert sowohl ein Semikolon als auch ein Doppeltes Anführungszeichen enthält, kann der Wert in einfache Anführungszeichen eingeschlossen werden. Das einfache Anführungszeichen ist auch nützlich, wenn der Wert mit einem doppelten Anführungszeichen beginnt. Umgekehrt kann das doppelte Anführungszeichen verwendet werden, wenn der Wert mit einem einzelnen Anführungszeichen beginnt. Wenn der Wert sowohl Ein- als auch Doppelte Anführungszeichen enthält, muss das zum Einschließen des Werts verwendete Anführungszeichen jedes Mal verdoppelt werden, wenn er innerhalb des Werts auftritt.

Um vor- oder nachgestellte Leerzeichen in den Zeichenfolgenwert einzuschließen, muss der Wert in einfache Anführungszeichen oder doppelte Anführungszeichen eingeschlossen werden. Alle führenden oder nachfolgenden Leerzeichen um ganzzahlige, boolesche oder aufgezählte Werte werden ignoriert, auch wenn sie in Anführungszeichen eingeschlossen sind. Leerzeichen innerhalb eines Zeichenfolgenliteralschlüsselworts oder -werts bleiben jedoch erhalten. Einfache oder doppelte Anführungszeichen können in einer Verbindungszeichenfolge verwendet werden, ohne Trennzeichen zu verwenden, es sei denn, Data Source= my'Server ein Anführungszeichen ist das erste oder letzte Zeichen im Wert, z. B. oder Data Source= my"Server.

Um ein Gleichheitszeichen (=) in ein Schlüsselwort oder einen Wert einzuschließen, muss es einem anderen Gleichheitszeichen vorangestellt werden. Beispiel: in der hypothetischen Verbindungszeichenfolge

"key==word=value"

Das Schlüsselwort lautet "key=word", und der Wert ist "value".

Wenn ein bestimmtes Schlüsselwort in einem Schlüsselwort-Wert-Paar mehr als einmal in einer Verbindungszeichenfolge auftritt, wird das letzte Vorkommen in der Wertmenge verwendet.

Bei Schlüsselwörtern wird die Groß-/Kleinschreibung nicht beachtet.

In der folgenden Tabelle sind die gültigen Namen für Werte in der ConnectionStringTabelle aufgeführt.

In der folgenden Tabelle sind die gültigen Namen für Verbindungspoolwerte in der ConnectionStringTabelle aufgeführt.

Wenn Sie Schlüsselwort- oder Verbindungspoolwerte festlegen, die einen booleschen Wert erfordern, können Sie "ja" anstelle von "true" und "nein" anstelle von "false" verwenden. Ganze Zahlen werden als Zeichenfolgen dargestellt.