SqlConnectionStringBuilder Konstruktoren

  • Referenz

Definition

Namespace:
System.Data.SqlClient
Assembly:
System.Data.SqlClient.dll
Assembly:
System.Data.dll

Initialisiert eine neue Instanz der SqlConnectionStringBuilder-Klasse.

Ü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 ()

Siehe auch

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 System.Data.SqlClient.SqlConnectionStringBuilder : string -> System.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

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).

ArgumentException

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

Imports System.Data.SqlClient

Module Module1
    Sub Main()
        Try
            Dim connectString As String = _
                "Server=(local);Database=AdventureWorks;UID=ab;Pwd=a!Pass@@"
            Console.WriteLine("Original: " & connectString)
            Dim builder As New SqlConnectionStringBuilder(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 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, in denen der Wert nicht der Standardwert für das Element ist.

Siehe auch

Gilt für