Freigeben über


SqlConnectionStringBuilder Konstruktoren

Definition

Überlädt

SqlConnectionStringBuilder()

Initialisiert eine neue Instanz der SqlConnectionStringBuilder-Klasse.

SqlConnectionStringBuilder(String)

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

SqlConnectionStringBuilder()

Initialisiert eine neue Instanz der SqlConnectionStringBuilder-Klasse.

public:
 SqlConnectionStringBuilder();
public SqlConnectionStringBuilder ();
Public Sub New ()

Gilt für:

SqlConnectionStringBuilder(String)

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

public:
 SqlConnectionStringBuilder(System::String ^ connectionString);
public SqlConnectionStringBuilder (string connectionString);
new Microsoft.Data.SqlClient.SqlConnectionStringBuilder : string -> Microsoft.Data.SqlClient.SqlConnectionStringBuilder
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

Ungültiger Schlüsselname in der Verbindungszeichenfolge.

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

Die bereitgestellte connectionString ist ungültig.

Beispiele

Im folgenden Beispiel wird eine einfache SQL Server-Verbindungszeichenfolge im Konstruktor des SqlConnectionStringBuilder-Objekts angegeben. Anschließend werden alle Schlüssel-Wert-Paare im Objekt durchlaufen. Die Sammlung enthält Standardwerte für jedes Element. Die SqlConnectionStringBuilder-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 SqlConnectionStringBuilder 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.

using Microsoft.Data.SqlClient;

class Program
{
    static void Main()
    {
        try
        {
            string connectString =
                "Server=(local);Database=AdventureWorks;UID=ab;Pwd= a!Pass@@";
            Console.WriteLine("Original: " + connectString);
            SqlConnectionStringBuilder builder =
                new SqlConnectionStringBuilder(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);
        }
    }
}

Hinweise

Die SqlConnectionStringBuilder-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, bei denen der Wert nicht der Standardwert für das Element ist.

Gilt für: