DbConnectionStringBuilder.ConnectionString Egenskap

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

Egenskapsvärde

Den aktuella reťazec pripojenia som skapats från nyckel/värde-paren som finns i DbConnectionStringBuilder. Standardvärdet är en tom sträng.

Undantag

Exempel

I följande exempel visas möjliga beteenden för egenskapen ConnectionString . Exemplet:

• Skapar en reťazec pripojenia genom att lägga till nyckel/värde-par, ett i taget, till en tom DbConnectionStringBuilder.

• Tilldelar en fullständig reťazec pripojenia till egenskapen ConnectionString för instansen DbConnectionStringBuilder och ändrar ett enda nyckel/värde-par i strängen.

• Tilldelar en godtycklig uppsättning nyckel-/värdepar till egenskapen ConnectionString (dvs. en sträng som inte är något som liknar en reťazec pripojenia) och ändrar ett av värdena.

• Tilldelar en ogiltig reťazec pripojenia till egenskapen ConnectionString, vilket visar undantaget som genereras.

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

Kommentarer

Den här egenskapen returnerar en semikolonavgränsad lista över nyckel/värde-par som lagras i samlingen som underhålls av DbConnectionStringBuilder. Varje par innehåller nyckeln och värdet, avgränsade med ett likhetstecken. I följande exempel visas en typisk reťazec pripojenia.

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

Dataprovidrar kan förvänta sig specifika nycklar och värden för varje reťazec pripojenia egenskap. , Dessa värden dokumenteras individuellt. Klassen DbConnectionStringBuilder verifierar inte nyckel/värde-paren som är associerade med dess reťazec pripojenia, även om klasser som ärver från den kan.

Egenskapen ConnectionStringDbConnectionStringBuilder för klassen fungerar vanligtvis som en mekanism för att skapa och parsa semikolonavgränsade listor över nyckel/värde-par avgränsade med likhetstecken. Det ger ingen validering eller annat stöd som är specifikt för anslutningssträngar. Om du lägger till objekt i DbConnectionStringBuilder samlingen återspeglar egenskapen ConnectionString ändringarna. Om du tilldelar egenskapen ett värde ConnectionStringDbConnectionStringBuilder försöker du parsa värdet med semikolon- och likhetsavgränsarna.

Se även

• Anslutningssträngar i ADO.NET
• översikt över ADO.NET