DbConnectionStringBuilder.ConnectionString Özellik

Tanım

Ad Alanı:

System.Data.Common

Bütünleştirilmiş Kod:

System.Data.Common.dll

Kaynak:

DbConnectionStringBuilder.cs

ile DbConnectionStringBuilderilişkili bağlantı dizesi alır veya ayarlar.

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

Özellik Değeri

String

içinde yer alan DbConnectionStringBuilderanahtar/değer çiftlerinden oluşturulan geçerli bağlantı dizesi. Varsayılan değer boş bir dizedir.

Özel durumlar

ArgumentException

Geçersiz bir bağlantı dizesi bağımsız değişkeni sağlandı.

Örnekler

Aşağıdaki örnekte özelliğin olası davranışları gösterilmektedir ConnectionString . Örnek:

• Boş DbConnectionStringBuilderbir öğesine birer birer anahtar/değer çiftleri ekleyerek bir bağlantı dizesi oluşturur.

• Örneğin özelliğine ConnectionStringDbConnectionStringBuilder tam bir bağlantı dizesi atar ve dize içindeki tek bir anahtar/değer çiftini değiştirir.

• özelliğine ConnectionString rastgele bir anahtar/değer çifti kümesi atar (başka bir ifadeyle, bağlantı dizesi gibi olmayan bir dize) ve değerlerden birini değiştirir.

• Özelliğine ConnectionString geçersiz bir bağlantı dizesi atayarak oluşan özel durumu gösterir.

Not

Bu örnek, bağlantı dizeleriyle nasıl DbConnectionStringBuilder çalıştığını gösteren bir parola içerir. Uygulamalarınızda Windows Kimlik Doğrulaması kullanmanızı öneririz. Bir parola kullanmanız gerekiyorsa, uygulamanıza sabit kodlanmış bir parola eklemeyin.

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

Açıklamalar

Bu özellik, tarafından DbConnectionStringBuildertutulan koleksiyonda depolanan anahtar/değer çiftlerinin noktalı virgülle ayrılmış bir listesini döndürür. Her çift, eşittir işaretiyle ayrılmış olarak anahtarı ve değeri içerir. Aşağıdaki örnekte tipik bir bağlantı dizesi gösterilmektedir.

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

Veri sağlayıcıları her bağlantı dizesi özelliği için belirli anahtarlar ve değerler bekleyebilirsiniz. , Bu değerler tek tek belgelenir. sınıfıDbConnectionStringBuilder, bağlantı dizesi ile ilişkili anahtar/değer çiftlerini doğrulamaz, ancak sınıflardan devralan sınıflar doğrulayabilir.

ConnectionString sınıfının özelliği DbConnectionStringBuilder genellikle eşit işaretlerle ayrılmış noktalı virgülle ayrılmış anahtar/değer çiftlerinin listelerini oluşturmak ve ayrıştırmak için bir mekanizma işlevi görür. Bağlantı dizelerine özgü doğrulama veya başka destek sağlamaz. Koleksiyona DbConnectionStringBuilder öğe eklerseniz, ConnectionString özelliği değişiklikleri yansıtır. özelliğine ConnectionString bir değer atarsanız, DbConnectionStringBuilder noktalı virgül ve eşittir işareti sınırlayıcılarını kullanarak değeri ayrıştırmaya çalışır.

Ayrıca bkz.

• ADO.NET'da Bağlantı Dizeleri
• ADO.NET’e Genel Bakış