DbConnectionStringBuilder.ConnectionString Vlastnost

Definice

Obor názvů:

System.Data.Common

Sestavení:

netstandard.dll, System.Data.Common.dll

Zdroj:

DbConnectionStringBuilder.cs

Získá nebo nastaví připojovací řetězec přidružený k 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

Hodnota vlastnosti

String

Aktuální připojovací řetězec vytvořený z párů klíč/hodnota, které jsou obsaženy v souboru DbConnectionStringBuilder. Výchozí hodnota je prázdný řetězec.

Výjimky

ArgumentException

Byl zadán neplatný argument připojovacího řetězce.

Příklady

Následující příklad ukazuje možné chování ConnectionString vlastnosti. Příklad:

• Vytvoří připojovací řetězec přidáním párů klíč/hodnota po jednom do prázdného DbConnectionStringBuilderobjektu .

• Přiřadí úplný připojovací řetězec vlastnosti ConnectionStringDbConnectionStringBuilder instance a upraví v řetězci jeden pár klíč/hodnota.

• Přiřadí ke vlastnosti libovolnou sadu párů ConnectionString klíč/hodnota (tj. řetězec, který není vzdáleně podobný připojovacímu řetězci) a upraví jednu z hodnot.

• Přiřadí vlastnosti ConnectionString neplatný připojovací řetězec, který demonstruje výjimku, která je vyvolán.

Poznámka:

Tento příklad obsahuje heslo, které ukazuje, jak DbConnectionStringBuilder funguje s připojovacími řetězci. Ve svých aplikacích doporučujeme používat ověřování systému Windows. Pokud musíte použít heslo, nezahrnujte do aplikace pevně zakódované heslo.

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

Poznámky

Tato vlastnost vrátí středník oddělený seznam párů klíč/hodnota uložených v kolekci DbConnectionStringBuilder, kterou udržuje . Každá dvojice obsahuje klíč a hodnotu oddělenou znaménkem rovná se. Následující příklad znázorňuje typický připojovací řetězec.

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

Zprostředkovatelé dat mohou pro každou vlastnost připojovacího řetězce očekávat konkrétní klíče a hodnoty. , Tyto hodnoty jsou zdokumentovány jednotlivě. Třída DbConnectionStringBuilder neověřuje páry klíč/hodnota přidružené k jeho připojovacímu řetězci, i když třídy, které z něj dědí, mohou.

Vlastnost ConnectionStringDbConnectionStringBuilder třídy funguje obecně jako mechanismus pro vytváření a parsování seznamů oddělených středníkem párů klíč/hodnota oddělených znaménkem rovná se. Neposkytuje žádné ověření ani jinou podporu specifickou pro připojovací řetězce. Pokud do DbConnectionStringBuilder kolekce přidáte položky, ConnectionString bude tato vlastnost odrážet změny. Pokud přiřadíte hodnotu vlastnosti ConnectionString , DbConnectionStringBuilder pokusí se parsovat hodnotu pomocí středníku a oddělovače rovnítko.

Viz také

• Připojovací řetězce v ADO.NET
• Přehled ADO.NET