OracleConnectionStringBuilder Konstruktoren

Definition

Namespace:

System.Data.OracleClient

Assembly:

System.Data.OracleClient.dll

Initialisiert eine neue Instanz der OracleConnectionStringBuilder-Klasse.

Überlädt

OracleConnectionStringBuilder()	Initialisiert eine neue Instanz der OracleConnectionStringBuilder-Klasse.
OracleConnectionStringBuilder(String)	Initialisiert eine neue Instanz der OracleConnectionStringBuilder-Klasse. Die bereitgestellte Verbindungszeichenfolge stellt die Daten für die internen Verbindungsinformationen der Instanz bereit.

OracleConnectionStringBuilder()

Initialisiert eine neue Instanz der OracleConnectionStringBuilder-Klasse.

public:
 OracleConnectionStringBuilder();

public OracleConnectionStringBuilder ();

Public Sub New ()

Weitere Informationen

• Erstellen von Verbindungszeichenfolgen

OracleConnectionStringBuilder(String)

Initialisiert eine neue Instanz der OracleConnectionStringBuilder-Klasse. Die bereitgestellte Verbindungszeichenfolge stellt die Daten für die internen Verbindungsinformationen der Instanz bereit.

public:
 OracleConnectionStringBuilder(System::String ^ connectionString);

public OracleConnectionStringBuilder (string connectionString);

new System.Data.OracleClient.OracleConnectionStringBuilder : string -> System.Data.OracleClient.OracleConnectionStringBuilder

Public Sub New (connectionString As String)

Parameter

connectionString

String

Die Grundlage für die internen Verbindungsinformationen der Objekte. Analysiert in Name-Wert-Paare. Ungültige Schlüsselnamen lösen eine KeyNotFoundException aus.

Ausnahmen

KeyNotFoundException

Ungültiger Schlüsselname in der Verbindungszeichenfolge.

FormatException

Ungültiger Wert in der Verbindungszeichenfolge (ein boolescher oder numerischer Wert wurde erwartet, jedoch nicht bereitgestellt).

Beispiele

Das folgende Beispiel stellt eine einfache Verbindungszeichenfolge im Konstruktor des OracleConnectionStringBuilder Objekts bereit und durchläuft dann alle Schlüssel-Wert-Paare innerhalb des -Objekts. Beachten Sie, dass die Auflistung Standardwerte für jedes Element bereitstellt. Die OracleConnectionStringBuilder-Klasse konvertiert Synonyme für die bekannten Schlüssel, damit sie mit den bekannten Namen konsistent sind.

Hinweis

Das Beispiel umfasst ein Kennwort zur Veranschaulichung der Funktion von OracleConnectionStringBuilder mit Verbindungszeichenfolgen. In den Anwendungen wird die Verwendung der Windows-Authentifizierung empfohlen. Wenn Sie ein Kennwort verwenden müssen, schließen Sie kein hartcodiertes Kennwort in die Anwendung ein.

// You may need to set a reference to the System.Data.OracleClient
// assembly before you can run this sample.
using System.Data.OracleClient;

class Program
{
    static void Main()
    {
        try
        {
            string connectString = "Server=OracleDemo;UID=Mary;Pwd=*****";
            Console.WriteLine("Original: " + connectString);
            OracleConnectionStringBuilder builder =
                new OracleConnectionStringBuilder(connectString);
            Console.WriteLine("Modified: " + builder.ConnectionString);
            foreach (string key in builder.Keys)
                Console.WriteLine(key + "=" + builder[key].ToString());
            Console.WriteLine("Press any key to finish.");
            Console.ReadLine();
        }
        catch (System.Collections.Generic.KeyNotFoundException ex)
        {
            Console.WriteLine("KeyNotFoundException: " + ex.Message);
        }
        catch (System.FormatException ex)
        {
            Console.WriteLine("Format exception: " + ex.Message);
        }
    }
}

' You may need to set a reference to the System.Data.OracleClient
' assembly before running this example.
Imports System.Data.OracleClient

Module Module1
  Sub Main()
    Try
      Dim connectString As String = "Server=OracleDemo;UID=Mary;Pwd=*****"
      Console.WriteLine("Original: " & connectString)
      Dim builder As New OracleConnectionStringBuilder(connectString)
      Console.WriteLine("Modified: " & builder.ConnectionString)
      For Each key As String In builder.Keys
        Console.WriteLine(key & "=" & builder.Item(key).ToString)
      Next
      Console.WriteLine("Press any key to finish.")
      Console.ReadLine()

    Catch ex As System.Collections.Generic.KeyNotFoundException
      Console.WriteLine("KeyNotFoundException: " & ex.Message)
    Catch ex As System.FormatException
      Console.WriteLine("Format exception: " & ex.Message)
    End Try
  End Sub

End Module

Hinweise

Die OracleConnectionStringBuilder-Klasse beinhaltet eine feste interne Sammlung von Schlüssel-Wert-Paaren. Auch wenn Sie nur eine kleine Teilmenge der möglichen Verbindungszeichenfolgenwerte im Konstruktor angeben, stellt das Objekt für jedes Schlüssel-Wert-Paar immer Standardwerte bereit. Wenn die ConnectionString -Eigenschaft des -Objekts abgerufen wird, enthält die Zeichenfolge nur Schlüssel-Wert-Paare, in denen sich der Wert vom Standardwert für das Element unterscheidet.

Weitere Informationen

• Erstellen von Verbindungszeichenfolgen