SqlConnectionStringBuilder Konstruktoren
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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 ()Weitere Informationen
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.SqlConnectionStringBuilderPublic 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 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, bei denen der Wert nicht der Standardwert für das Element ist.
