OracleConnection.ConnectionString Eigenschaft

Definition

Namespace:

System.Data.OracleClient

Assembly:

System.Data.OracleClient.dll

Ruft die Zeichenfolge ab, mit der eine Oracle-Datenbank geöffnet wird, oder legt diese fest.

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

[System.ComponentModel.SettingsBindable(true)]
public override string ConnectionString { get; set; }

[<System.ComponentModel.SettingsBindable(true)>]
member this.ConnectionString : string with get, set

Public Overrides Property ConnectionString As String

Eigenschaftswert

String

Die Oracle-Verbindungszeichenfolge mit den erforderlichen Einstellungen zum erstmaligen Herstellen der Verbindung (z. B. dem Servernamen). Der Standardwert ist eine leere Zeichenfolge ("").

Attribute

SettingsBindableAttribute

Beispiele

Im folgenden Beispiel wird ein OracleConnection erstellt und einige seiner Eigenschaften im Verbindungszeichenfolge festgelegt.

public void CreateOracleConnection()
{
    string connectionString = "Data Source=Oracle8i;Integrated Security=yes";
    using (OracleConnection connection = new OracleConnection(connectionString))
    {
        connection.Open();
        Console.WriteLine("ServerVersion: " + connection.ServerVersion
            + "\nDataSource: " + connection.DataSource);
    }
}

Public Sub CreateOracleConnection()
    Dim connectionString As String = _
       "Data Source=Oracle8i;Integrated Security=yes"

    Using connection As New OracleConnection(connectionString)
        connection.Open()
        Console.WriteLine("ServerVersion: " + connection.ServerVersion _
           + ControlChars.NewLine + "DataSource: " + connection.DataSource)
    End Using
End Sub

Hinweise

Kann ConnectionString nur festgelegt werden, wenn die Verbindung geschlossen wird.

Sie können die ConnectionString -Eigenschaft verwenden, um eine Verbindung mit einer Datenbank herzustellen. Das folgende Beispiel veranschaulicht eine typische Verbindungszeichenfolge.

"Data Source=Oracle8i;Integrated Security=yes"  

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

Beim Zurücksetzen von ConnectionString für eine geschlossene Verbindung werden alle Verbindungszeichenfolge Werte (und zugehörigen Eigenschaften) einschließlich des Kennworts zurückgesetzt.

Die Verbindungszeichenfolge wird unmittelbar nach dem Festlegen analysiert. Wenn bei der Analyse Syntaxfehler angezeigt werden, wird eine Laufzeit-Ausnahme wie ArgumentExceptiongeneriert. Andere Fehler können nur gefunden werden, wenn versucht wird, die Verbindung zu öffnen.

Das Basisformat eines Verbindungszeichenfolge besteht aus einer Reihe von Schlüsselwort (keyword)-Wert-Paaren, die durch Semikolons getrennt sind. Ein Gleichheitszeichen (=) verbindet jedes Schlüsselwort mit seinem 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 einfachen Anführungszeichen beginnt. Wenn der Wert sowohl einfache als auch doppelte Anführungszeichen enthält, muss das Anführungszeichen, das zum Einschließen des Werts verwendet wird, jedes Mal verdoppelt werden, wenn er innerhalb des Werts auftritt.

Um vorangehende oder nachfolgende Leerzeichen in den Zeichenfolgenwert einzuschließen, muss der Wert entweder in einfache 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 Zeichenfolgenliterals Schlüsselwort (keyword) oder -Werts werden jedoch beibehalten. Einfache oder doppelte Anführungszeichen können innerhalb eines Verbindungszeichenfolge ohne Trennzeichen verwendet werden, es sei denn, ein Anführungszeichen ist das erste oder letzte Zeichen im Wert, zData Source= my'Server. B. oder Data Source= my"Server.

Um ein Gleichheitszeichen (=) in eine Schlüsselwort (keyword) oder einen Wert einzuschließen, muss ihm ein weiteres Gleichheitszeichen vorangestellt werden. Beispielsweise in der hypothetischen Verbindungszeichenfolge

"key==word=value"  

der Schlüsselwort (keyword) ist "key=word" und der Wert ist "value".

Wenn ein bestimmter Schlüsselwort (keyword) in einem Schlüsselwort (keyword)/Wert-Paar mehr als einmal in einem Verbindungszeichenfolge auftritt, wird das letzte Vorkommen im Wertsatz verwendet.

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

In der folgenden Tabelle sind die gültigen Namen für Werte innerhalb des ConnectionStringaufgeführt.

Name	Standard	BESCHREIBUNG
Data source - oder - Server		Der Name oder die Netzwerkadresse des instance von Oracle, mit dem eine Verbindung hergestellt werden soll.
Integrierte Sicherheit	"false"	Ob die Verbindung eine sichere Verbindung sein muss. Erkannte Werte sind true (dringend empfohlen), false, yesund no.
Kennwort		Das Kennwort für die Anmeldung des Oracle-Kontos. Um ein hohes Sicherheitsniveau zu gewährleisten, wird dringend empfohlen, stattdessen die integrierte Sicherheits-Schlüsselwort (keyword) zu verwenden.
Sicherheitsinformationen permanent speichern	"false"	Bei Festlegung auf false oder no (dringend empfohlen) werden sicherheitsrelevante Informationen wie das Kennwort nicht als Teil der Verbindung zurückgegeben, wenn die Verbindung geöffnet ist oder sich jemals in einem geöffneten Statebefindet. Beim Zurücksetzen der Verbindungszeichenfolge werden alle Verbindungszeichenfolge Werte zurückgesetzt, einschließlich des Kennworts. Erkannte Werte sind true, false, yes und no.
Unicode	"false"	Gibt an, ob der .NET Framework-Datenanbieter für Oracle API-Aufrufe im UTF16-Modus verwendet. Diese Schlüsselwort (keyword) wird außer bei Verwendung der Oracle9i-Clientsoftware ignoriert.
Benutzer-ID		Das Oracle-Anmeldekonto. Um ein hohes Sicherheitsniveau zu gewährleisten, wird dringend empfohlen, stattdessen die integrierte Sicherheits-Schlüsselwort (keyword) zu verwenden.

In der folgenden Tabelle sind die gültigen Namen für Verbindungspoolingwerte innerhalb des ConnectionStringaufgeführt.

Name	Standard	BESCHREIBUNG
Verbindungslebensdauer	0	Wenn eine Verbindung an den Pool zurückgegeben wird, wird die Erstellungszeit mit der aktuellen Zeit verglichen. Wenn diese Zeitspanne (in Sekunden) größer ist als der für die Connection Lifetime angegebene Wert, wird die Verbindung zerstört. Dies ist hilfreich bei Gruppenkonfigurationen, um einen Lastenausgleich zwischen einem bereits aktiven Server und einem Server zu erzwingen, der gerade erst online gegangen ist. Der Wert 0 (null) bewirkt, dass für gepoolte Verbindungen das maximale Verbindungstimeout aufgetreten ist.
Enlist	"true"	Wenn true oder yesist, listet der Pooler die Verbindung automatisch im aktuellen Transaktionskontext des Erstellungsthreads ein. Erkannte Werte sind true, false, yes und no.
Max Pool Size	100	Die maximale Anzahl der im Pool zulässigen Verbindungen. Das Festlegen des Max Pool Size Werts von kann sich auf die ConnectionString Leistung auswirken. Wenn Sie planen, mehr als 100 Verbindungen zu erstellen und aktiv zu verwenden, sollten Sie auf einen Wert erhöhen Max Pool Size , der der Nutzung der stabilen Verbindung für die Anwendung entspricht.
Min Pool Size	0	Die mindest zulässige Anzahl von Verbindungen im Pool.
Pooling	"true"	Wenn true oder yesist, wird das OracleConnection Objekt aus dem entsprechenden Pool gezeichnet oder bei Bedarf erstellt und dem entsprechenden Pool hinzugefügt. Erkannte Werte sind true, false, yes und no.

Wenn Sie Schlüsselwort (keyword)- oder Verbindungspoolingwerte festlegen, die einen booleschen Wert erfordern, können Sie "ja" anstelle von "true" und "nein" anstelle von "false" verwenden. Ganzzahlige Werte werden als Zeichenfolgen dargestellt.