OracleConnection.ConnectionString-Eigenschaft

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

Namespace: System.Data.OracleClient
Assembly: System.Data.OracleClient (in system.data.oracleclient.dll)

Syntax

'Declaration
Public Overrides Property ConnectionString As String
'Usage
Dim instance As OracleConnection
Dim value As String

value = instance.ConnectionString

instance.ConnectionString = value

public override string ConnectionString { get; set; }

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

/** @property */
public String get_ConnectionString ()

/** @property */
public void set_ConnectionString (String value)

public override function get ConnectionString () : String

public override function set ConnectionString (value : String)

Eigenschaftenwert

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

Hinweise

Der ConnectionString kann nur festgelegt werden, wenn die Verbindung geschlossen ist.

Mithilfe der ConnectionString-Eigenschaft können Sie eine Verbindung zu einer Datenbank herstellen. Das folgende Beispiel enthält eine typische Verbindungszeichenfolge.

"Data Source=Oracle8i;Integrated Security=yes"

Viele der in der Zeichenfolge angegebenen Einstellungen weisen entsprechende schreibgeschützte Eigenschaften auf (z. B. entspricht Data Source=MyServer der DataSource-Eigenschaft). Wenn die Verbindungszeichenfolge festgelegt wird, werden alle dieser Eigenschaften aktualisiert, sofern kein Fehler erkannt wird. In diesem Fall wird keine Eigenschaft aktualisiert. OracleConnection-Eigenschaften geben nur Standardeinstellungen oder die im ConnectionString angegebenen Einstellungen zurück.

Beim Zurücksetzen des ConnectionString für eine geschlossene Verbindung werden alle Verbindungszeichenfolgenwerte (und die zugeordneten Eigenschaften) einschließlich des Kennworts zurückgesetzt.

Die Verbindungszeichenfolge wird direkt nach dem Festlegen analysiert. Wenn bei der Analyse Syntaxfehler festgestellt werden, wird eine Laufzeitausnahme generiert, z. B. ArgumentException. Andere Fehler können erst gefunden werden, wenn versucht wird, die Verbindung herzustellen.

Das Grundformat einer Verbindungszeichenfolge besteht aus einer Reihe von Schlüsselwort-Wert-Paaren, die durch Semikolons getrennt sind. Ein Gleichheitszeichen (=) verbindet jedes Schlüsselwort mit seinem Wert. Werte, die ein Semikolon, ein einfaches oder ein doppeltes Anführungszeichen enthalten, müssen in doppelte Anführungszeichen eingeschlossen werden. Wenn der Wert sowohl ein Semikolon als auch ein doppeltes Anführungszeichen enthält, muss er in einfache Anführungszeichen eingeschlossen werden. Einfache Anführungszeichen sind auch sinnvoll, wenn der Wert mit einem doppelten Anführungszeichen beginnt. Genauso können 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, müssen die Anführungszeichen, die den Wert umschließen, innerhalb des Werts immer doppelt verwendet werden.

Wenn führende oder nachstehende Leerzeichen in einen Zeichenfolgenwert eingeschlossen werden sollen, muss der Wert in einfachen oder doppelten Anführungszeichen angegeben werden. Führende oder nachstehende Leerzeichen um ganzzahlige oder boolesche Werte bzw. Enumerationswerte werden nicht berücksichtigt. Das gilt auch für den Fall, dass sie in Klammern eingeschlossen sind. Leerzeichen in einem Schlüsselwort oder Wert für Zeichenfolgenliterale werden jedoch beibehalten. In einer Verbindungszeichenfolge können einfache oder doppelte Anführungszeichen ohne Trennzeichen verwendet werden, sofern das erste oder letzte Zeichen im Wert kein Anführungszeichen ist, z. B. Data Source= my'Server oder Data Source= my"Server.

Wenn ein Schlüsselwort oder ein Wert ein Gleichheitszeichen (=) enthalten soll, muss diesem ein weiteres Gleichheitszeichen vorangestellt werden. Beispielsweise lautet in der hypothetischen Verbindungszeichenfolge

"key==word=value"

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

Wenn ein bestimmtes Schlüsselwort in einem Schlüsselwort-Wert-Paar mehrfach in einer Verbindungszeichenfolge vorhanden ist, wird das letzte Vorkommen im Wertesatz verwendet.

Bei Schlüsselwörtern wird die Groß- und Kleinschreibung nicht berücksichtigt.

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

In der folgenden Tabelle werden die gültigen Namen für Verbindungspoolingwerte im ConnectionString aufgelistet.

Beim Festlegen von Schlüsselwort- oder Verbindungspoolingwerten, die einen booleschen Wert erfordern, können Sie 'yes' anstelle von 'true' und 'no' anstelle von 'false' verwenden. Ganzzahlwerte werden als Zeichenfolgen dargestellt.

Beispiel

Im folgenden Beispiel wird eine OracleConnection erstellt, und einige ihrer Eigenschaften in der Verbindungszeichenfolge werden festgelegt.

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

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);
    }
}

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1

Siehe auch

Referenz

OracleConnection-Klasse
OracleConnection-Member
System.Data.OracleClient-Namespace