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 mit den erforderlichen Einstellungen zum erstmaligen Herstellen der Verbindung (z. B. dem Servernamen). Der Standardwert ist eine leere Zeichenfolge ("").

Implementiert

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.

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

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.

Gilt für: