DbConnectionStringBuilder.ConnectionString Eigenschaft

public:
 property System::String ^ ConnectionString { System::String ^ get(); void set(System::String ^ value); };

public string ConnectionString { get; set; }

member this.ConnectionString : string with get, set

Public Property ConnectionString As String

Eigenschaftswert

Die aktuelle Verbindungszeichenfolge, die aus den Schlüssel-Wert-Paaren erstellt wird, die in der DbConnectionStringBuilder. Der Standardwert ist eine leere Zeichenfolge.

Ausnahmen

Beispiele

Im folgenden Beispiel werden mögliche Verhaltensweisen der ConnectionString Eigenschaft veranschaulicht. Beispiel:

• Erstellt eine Verbindungszeichenfolge durch Hinzufügen von Schlüssel-Wert-Paaren einzeln zu einem leeren DbConnectionStringBuilder.

• Weist der ConnectionString Eigenschaft der DbConnectionStringBuilder Instanz eine vollständige Verbindungszeichenfolge zu und ändert ein einzelnes Schlüssel-Wert-Paar innerhalb der Zeichenfolge.

• Weist der ConnectionString Eigenschaft einen beliebigen Satz von Schlüssel-Wert-Paaren zu (d. h. einer Zeichenfolge, die nicht remote wie eine Verbindungszeichenfolge ist), und ändert einen der Werte.

• Weist der ConnectionString Eigenschaft eine ungültige Verbindungszeichenfolge zu, die die ausgelöste Ausnahme veranschaulicht.

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

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: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 durch Semikolons getrennte Liste von Schlüssel-Wert-Paaren zurück, die in der Auflistung gespeichert sind, die von der DbConnectionStringBuilder. Jedes Paar enthält den Schlüssel und 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-Wert-Paare, die der Verbindungszeichenfolge zugeordnet sind, obwohl Klassen, die von ihr erben, möglich sind.

Die ConnectionString Eigenschaft der DbConnectionStringBuilder Klasse fungiert im Allgemeinen als Mechanismus zum Erstellen und Analysieren von durch Semikolons getrennten Listen mit Schlüssel-Wert-Paaren, die durch Gleichheitszeichen getrennt sind. Es bietet keine Überprüfung oder andere Unterstützung speziell 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, wird versucht, DbConnectionStringBuilder den Wert mithilfe des Semikolons und gleichheitszeichentrennzeichens zu analysieren.

Weitere Informationen

• Verbindungszeichenfolgen in ADO.NET
• Übersicht über ADO.NET