DbConnectionStringBuilder.ConnectionString Eigenschap

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

Waarde van eigenschap

De huidige verbindingsreeks, gemaakt op basis van de sleutel-/waardeparen die zijn opgenomen in de DbConnectionStringBuilder. De standaardwaarde is een lege tekenreeks.

Uitzonderingen

Voorbeelden

In het volgende voorbeeld ziet u mogelijke gedragingen van de ConnectionString eigenschap. Het voorbeeld:

• Hiermee maakt u een verbindingsreeks door sleutel-/waardeparen één voor één toe te voegen aan een lege DbConnectionStringBuilder.

• Hiermee wordt een volledige verbindingsreeks toegewezen aan de eigenschap ConnectionString van het DbConnectionStringBuilder-exemplaar en wordt één sleutel/waardepaar in de tekenreeks gewijzigd.

• Wijst een willekeurige set sleutel-/waardeparen toe aan de eigenschap ConnectionString (dat wil zeggen, een tekenreeks die niet op afstand lijkt op een verbindingsreeks) en wijzigt een van de waarden.

• Wijst een ongeldige verbindingsreeks toe aan de eigenschap ConnectionString, waarmee de uitzondering wordt gedemonstreerd die wordt gegenereerd.

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

Opmerkingen

Deze eigenschap retourneert een door puntkomma's gescheiden lijst met sleutel-waardeparen die zijn opgeslagen in de verzameling die wordt onderhouden door de DbConnectionStringBuilder. Elk paar bevat de sleutel en waarde, gescheiden door een gelijkteken. In het volgende voorbeeld ziet u een typische verbindingsreeks.

"Persist Security Info=False;Integrated Security=SSPI;Initial Catalog=AdventureWorks;Data Source=(local)"

Gegevensproviders kunnen specifieke sleutels en waarden verwachten voor elke verbindingsreeks eigenschap. , Deze waarden worden afzonderlijk gedocumenteerd. De klasse DbConnectionStringBuilder valideert niet de sleutel-/waardeparen die zijn gekoppeld aan de bijbehorende verbindingsreeks, hoewel klassen die hiervan overnemen, wel kunnen worden gevalideerd.

De ConnectionString eigenschap van de DbConnectionStringBuilder klasse fungeert over het algemeen als mechanisme voor het maken en parseren van door puntkomma's gescheiden lijsten met sleutel-waardeparen, gescheiden door gelijktekens. Het biedt geen validatie of andere ondersteuning die specifiek is voor verbindingsreeksen. Als u items aan de DbConnectionStringBuilder verzameling toevoegt, geeft de ConnectionString eigenschap de wijzigingen weer. Als u een waarde aan de ConnectionString eigenschap toewijst, probeert de DbConnectionStringBuilder waarde te parseren met behulp van de scheidingstekens tussen puntkomma's en gelijktekens.

Zie ook

• Verbindingsreeksen in ADO.NET
• overzicht van ADO.NET