DbConnectionStringBuilder.Item[String] Özellik

Tanım

Ad Alanı:

System.Data.Common

Bütünleştirilmiş Kod:

System.Data.Common.dll

Kaynak:

DbConnectionStringBuilder.cs

Belirtilen anahtarla ilişkili değeri alır veya ayarlar.

public:
 virtual property System::Object ^ default[System::String ^] { System::Object ^ get(System::String ^ keyword); void set(System::String ^ keyword, System::Object ^ value); };

[System.ComponentModel.Browsable(false)]
public virtual object this[string keyword] { get; set; }

[<System.ComponentModel.Browsable(false)>]
member this.Item(string) : obj with get, set

Default Public Overridable Property Item(keyword As String) As Object

Parametreler

keyword

String

Alınacak veya ayarlanacağı öğenin anahtarı.

Özellik Değeri

Object

Belirtilen anahtarla ilişkili değer. Belirtilen anahtar bulunamazsa, almaya çalışmak bir null başvuru döndürür (Nothing Visual Basic'te) ve ayarlamaya çalışırken belirtilen anahtarı kullanarak yeni bir öğe oluşturur.

Null (Nothing Visual Basic'te) anahtarı geçirilmesi bir ArgumentNullExceptionoluşturur. Null değer atandıktan sonra anahtar/değer çifti kaldırılır.

Öznitelikler

BrowsableAttribute

Özel durumlar

ArgumentNullException

keyword bir null başvurudur (Nothing Visual Basic'te).

NotSupportedException

özelliği ayarlanır ve DbConnectionStringBuilder salt okunurdur.

-veya-

özelliği ayarlanır, keyword koleksiyonda yoktur ve sabit bir boyuta DbConnectionStringBuilder sahiptir.

Örnekler

Aşağıdaki konsol uygulaması yeni DbConnectionStringBuilder bir oluşturur ve özelliğini kullanarak bağlantı dizesi anahtar/değer çiftleri Item[] ekler.

static void Main()
{
    DbConnectionStringBuilder builder = new
        DbConnectionStringBuilder();
    builder["Data Source"] = "(local)";

    // Note that Item is the indexer, so
    // you do not include it in the reference.
    builder["integrated security"] = true;
    builder["Initial Catalog"] = "AdventureWorks";

    // Overwrite the existing value for the Data Source key,
    // because it already exists within the collection.
    builder["Data Source"] = ".";

    Console.WriteLine(builder.ConnectionString);
    Console.WriteLine();
    Console.WriteLine("Press Enter to continue.");
    Console.ReadLine();
}

Module Module1

    Sub Main()
        Dim builder As New DbConnectionStringBuilder
        builder.Item("Data Source") = "(local)"

        ' Item is the default property, so 
        ' you need not include it in the reference.
        builder("integrated security") = True
        builder.Item("Initial Catalog") = "AdventureWorks"

        ' Overwrite the existing value for the data source value, 
        ' because it already exists within the collection.
        builder.Item("Data Source") = "."

        Console.WriteLine(builder.ConnectionString)
        Console.WriteLine()
        Console.WriteLine("Press Enter to continue.")
        Console.ReadLine()
    End Sub

Açıklamalar

Bu özelliği ayarladığınızda, belirtilen anahtar sözlükte zaten varsa, değer değiştirilir; aksi takdirde, yeni bir öğe oluşturulur.

Ayrıca bkz.

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