DbConnectionStringBuilder.ConnectionString Eigenschaft

Definition

Ruft die Verbindungszeichenfolge ab, die dem DbConnectionStringBuilder zugeordnet ist, oder legt diese fest.Gets or sets the connection string associated with the DbConnectionStringBuilder.

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 im DbConnectionStringBuilder enthaltenen Schlüssel-Wert-Paaren erstellt wird.The current connection string, created from the key/value pairs that are contained within the DbConnectionStringBuilder. Der Standardwert ist eine leere Zeichenfolge.The default value is an empty string.

Ausnahmen

Es wurde ein ungültiges Argument für eine Verbindungszeichenfolge bereitgestellt.An invalid connection string argument has been supplied.

Beispiele

Im folgenden Beispiel werden mögliche Verhalten der ConnectionString -Eigenschaft veranschaulicht.The following example demonstrates possible behaviors of the ConnectionString property. Das Beispiel:The example:

  • Erstellt eine Verbindungs Zeichenfolge durch Hinzufügen von Schlüssel-Wert-Paaren einzeln zu einem leeren DbConnectionStringBuilder.Creates a connection string by adding key/value pairs, one at a time, to an empty DbConnectionStringBuilder.

  • Weist der ConnectionString -Eigenschaft DbConnectionStringBuilder der-Instanz eine komplette Verbindungs Zeichenfolge zu und ändert ein einzelnes Schlüssel-Wert-Paar in der Zeichenfolge.Assigns a complete connection string to the ConnectionString property of the DbConnectionStringBuilder instance, and modifies a single key/value pair within the string.

  • Weist der ConnectionString -Eigenschaft einen beliebigen Satz von Schlüssel-Wert-Paaren zu (d. h. eine Zeichenfolge, die keine Remote Verbindung zu einer Verbindungs Zeichenfolge hat) und ändert einen der-Werte.Assigns an arbitrary set of key/value pairs to the ConnectionString property (that is, a string that is not anything remotely like a connection string), and modifies one of the values.

  • Weist der ConnectionString -Eigenschaft eine ungültige Verbindungs Zeichenfolge zu und demonstriert die ausgelöste Ausnahme.Assigns an invalid connection string to the ConnectionString property, demonstrating the exception that is thrown.

Hinweis

Das Beispiel umfasst ein Kennwort zur Veranschaulichung der Funktion von DbConnectionStringBuilder mit Verbindungszeichenfolgen.This example includes a password to demonstrate how DbConnectionStringBuilder works with connection strings. In den Anwendungen wird die Verwendung der Windows-Authentifizierung empfohlen.In your applications, we recommend that you use Windows Authentication. Wenn Sie ein Kennwort verwenden müssen, schließen Sie kein hartcodiertes Kennwort in die Anwendung ein.If you must use a password, do not include a hard-coded password in your application.

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 durch Semikolons getrennte Liste von Schlüssel-Wert-Paaren zurück, die in der Auflistung DbConnectionStringBuildergespeichert sind, die von verwaltet wird.This property returns a semicolon-delimited list of key/value pairs stored within the collection maintained by the DbConnectionStringBuilder. Jedes Paar enthält den Schlüssel und den Wert, getrennt durch ein Gleichheitszeichen.Each pair contains the key and value, separated by an equal sign. Im folgenden Beispiel wird eine typische Verbindungs Zeichenfolge veranschaulicht.The following example illustrates a typical connection string.

"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 Eigenschaft der Verbindungs Zeichenfolge.Data providers may expect specific keys and values for each connection string property. Diese Werte werden einzeln dokumentiert., These values are documented individually. Die DbConnectionStringBuilder -Klasse überprüft nicht die Schlüssel-Wert-Paare, die der Verbindungs Zeichenfolge zugeordnet sind, obwohl Klassen, die von dieser Klasse erben, möglich sind.The DbConnectionStringBuilder class does not validate the key/value pairs associated with its connection string, although classes that inherit from it can.

Die ConnectionString -Eigenschaft DbConnectionStringBuilder der-Klasse fungiert im Allgemeinen als Mechanismus zum Erstellen und durch Semikolons getrennte Listen von Schlüssel-Wert-Paaren, die durch Gleichheitszeichen getrennt sind.The ConnectionString property of the DbConnectionStringBuilder class acts generally as a mechanism for creating and parsing semicolon-delimited lists of key/value pairs separated with equal signs. Er bietet keine Validierung oder andere Unterstützung für Verbindungs Zeichenfolgen.It provides no validation or other support specific to connection strings. Wenn Sie der DbConnectionStringBuilder Auflistung Elemente hinzufügen, reflektiert ConnectionString die-Eigenschaft die Änderungen.If you add items to the DbConnectionStringBuilder collection, the ConnectionString property will reflect the changes. Wenn Sie der ConnectionString -Eigenschaft einen Wert zuweisen, versucht DbConnectionStringBuilder die, den Wert mithilfe der Trennzeichen Semikolon und Gleichheitszeichen zu analysieren.If you assign a value to the ConnectionString property, the DbConnectionStringBuilder will try to parse the value, using the semicolon and equal-sign delimiters.

Gilt für:

Siehe auch