DbConnectionStringBuilder.ConnectionString Eigenschaft
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.
Ruft die dem DbConnectionStringBuilder zugeordnete Verbindungszeichenfolge ab oder legt sie fest.
public:
property System::String ^ ConnectionString { System::String ^ get(); void set(System::String ^ value); };public string ConnectionString { get; set; }member this.ConnectionString : string with get, setPublic Property ConnectionString As StringEigenschaftswert
Die aktuelle Verbindungszeichenfolge, die aus den im DbConnectionStringBuilder enthaltenen Schlüssel-Wert-Paaren erstellt wird. Der Standardwert ist eine leere Zeichenfolge.
Ausnahmen
Es wurde ein ungültiges Argument für eine Verbindungszeichenfolge bereitgestellt.
Beispiele
Im folgenden Beispiel werden mögliche Verhaltensweisen der ConnectionString Eigenschaft veranschaulicht. Beispiel:
Erstellt eine Verbindungszeichenfolge durch Hinzufügen von Schlüssel-/Wertpaaren jeweils zu einer leeren DbConnectionStringBuilder.
Weist eine vollständige Verbindungszeichenfolge der ConnectionString Eigenschaft der Instanz zu und ändert ein einzelnes Schlüssel-Wert-Paar innerhalb der DbConnectionStringBuilder Zeichenfolge.
Weist eine beliebige Gruppe von Schlüssel-/Wertpaaren der ConnectionString Eigenschaft zu (das heißt, eine Zeichenfolge, die nicht remote wie eine Verbindungszeichenfolge ist), und ändert eine der Werte.
Weist eine ungültige Verbindungszeichenfolge der ConnectionString Eigenschaft zu, die die Ausnahme anzeigt, die ausgelöst wird.
Hinweis
Das Beispiel umfasst ein Kennwort zur Veranschaulichung der Funktion von DbConnectionStringBuilder 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.
static void Main()
{
// Create a new DbConnctionStringBuilder, and add items
// to the internal collection of key/value pairs.
DbConnectionStringBuilder builder = new
DbConnectionStringBuilder();
builder.Add("Data Source", @"c:\MyData\MyDb.mdb");
builder.Add("Provider", "Microsoft.Jet.Oledb.4.0");
builder.Add("Jet OLEDB:Database Password", "********");
builder.Add("Jet OLEDB:System Database",
@"c:\MyData\Workgroup.mdb");
// Set up row-level locking.
builder.Add("Jet OLEDB:Database Locking Mode", 1);
// Display the contents of the connection string, which
// will now contain all the key/value pairs delimited with
// semicolons.
Console.WriteLine(builder.ConnectionString);
Console.WriteLine();
// Clear the DbConnectionStringBuilder, and assign a complete
// connection string to it, to demonstrate how
// the class parses connection strings.
builder.Clear();
builder.ConnectionString =
"Data Source=(local);Initial Catalog=AdventureWorks;"
+ "Integrated Security=SSPI";
// The DbConnectionStringBuilder class has parsed the contents,
// so you can work with any individual key/value pair.
builder["Data Source"] = ".";
Console.WriteLine(builder.ConnectionString);
Console.WriteLine();
// Because the DbConnectionStringBuilder class doesn't
// validate its key/value pairs, you can use this class
// to store any semicolon-delimited list. The following
// snippet places an arbitrary string into the ConnectionString
// property, changes one of the values, and then displays the
// resulting string.
builder.Clear();
builder.ConnectionString =
"Value1=10;Value2=20;Value3=30;Value4=40";
builder["Value2"] = 25;
Console.WriteLine(builder.ConnectionString);
Console.WriteLine();
builder.Clear();
try
{
// Assigning an invalid connection string
// throws an ArgumentException.
builder.ConnectionString = "xxx";
}
catch (ArgumentException)
{
Console.WriteLine("Invalid connection string.");
}
Console.WriteLine();
Console.WriteLine("Press Enter to finish.");
Console.ReadLine();
}
Sub Main()
' Create a new DbConnctionStringBuilder, and add items
' to the internal collection of key/value pairs.
Dim builder As New DbConnectionStringBuilder()
builder.Add("Data Source", "c:\MyData\MyDb.mdb")
builder.Add("Provider", "Microsoft.Jet.Oledb.4.0")
builder.Add("Jet OLEDB:Database Password", "*******")
builder.Add("Jet OLEDB:System Database", _
"c:\MyData\Workgroup.mdb")
' Set up row-level locking.
builder.Add("Jet OLEDB:Database Locking Mode", 1)
' Display the contents of the connection string, which
' will now contain all the key/value pairs delimited with
' semicolons.
Console.WriteLine(builder.ConnectionString)
Console.WriteLine()
' Clear the DbConnectionStringBuilder, and assign a complete
' connection string to it, to demonstrate how
' the class parses connection strings.
builder.Clear()
builder.ConnectionString = _
"Data Source=(local);Initial Catalog=AdventureWorks;" & _
"Integrated Security=SSPI"
' The DbConnectionStringBuilder class has parsed the contents,
' so you can work with any individual key/value pair.
builder("Data Source") = "."
Console.WriteLine(builder.ConnectionString)
Console.WriteLine()
' Because the DbConnectionStringBuilder class doesn't
' validate its key/value pairs, you can use this class
' to store any semicolon-delimited list. The following
' snippet places an arbitrary string into the ConnectionString
' property, changes one of the values, and then displays the
' resulting string.
builder.Clear()
builder.ConnectionString = _
"Value1=10;Value2=20;Value3=30;Value4=40"
builder("Value2") = 25
Console.WriteLine(builder.ConnectionString)
Console.WriteLine()
builder.Clear()
Try
' Assigning an invalid connection string
' throws an ArgumentException.
builder.ConnectionString = "xxx"
Catch ex As ArgumentException
Console.WriteLine("Invalid connection string.")
End Try
Console.WriteLine()
Console.WriteLine("Press Enter to finish.")
Console.ReadLine()
End Sub
Hinweise
Diese Eigenschaft gibt eine semikolonsdetrennte Liste von Schlüssel-Wert-Paaren zurück, die in der von der DbConnectionStringBuilderAuflistung verwalteten Auflistung gespeichert sind. Jedes Paar enthält den Schlüssel und den Wert, getrennt durch ein Gleichheitszeichen. Im folgenden Beispiel wird eine typische Verbindungszeichenfolge veranschaulicht.
"Persist Security Info=False;Integrated Security=SSPI;Initial Catalog=AdventureWorks;Data Source=(local)"
Datenanbieter erwarten möglicherweise bestimmte Schlüssel und Werte für jede Verbindungszeichenfolgeneigenschaft. , Diese Werte werden einzeln dokumentiert. Die DbConnectionStringBuilder Klasse überprüft nicht die Schlüssel-/Wertpaare, die ihrer Verbindungszeichenfolge zugeordnet sind, obwohl Klassen, die von ihm erben, nicht möglich sind.
Die ConnectionString Eigenschaft der Klasse fungiert in der DbConnectionStringBuilder Regel als Mechanismus zum Erstellen und Analysieren von semikolonsgetrennten Listen von Schlüssel-/Wertpaaren, die mit Gleichheitszeichen getrennt sind. Es bietet keine Überprüfung oder andere Unterstützung für Verbindungszeichenfolgen. Wenn Sie der DbConnectionStringBuilder Auflistung Elemente hinzufügen, spiegelt die ConnectionString Eigenschaft die Änderungen wider. Wenn Sie der ConnectionString Eigenschaft einen Wert zuweisen, versucht dies DbConnectionStringBuilder , den Wert mithilfe des Semikolons und gleichzeichende Trennzeichen zu analysieren.