DbConnectionStringBuilder.Item[String] Özellik

Tanım

Ad Alanı:
System.Data.Common
Bütünleştirilmiş Kod:
System.Data.Common.dll
Bütünleştirilmiş Kodlar:
netstandard.dll, System.Data.Common.dll
Bütünleştirilmiş Kod:
System.Data.dll
Bütünleştirilmiş Kod:
netstandard.dll
Kaynak:
DbConnectionStringBuilder.cs
Kaynak:
DbConnectionStringBuilder.cs
Kaynak:
DbConnectionStringBuilder.cs
Kaynak:
DbConnectionStringBuilder.cs
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); };
public virtual object this[string keyword] { get; set; }
[System.ComponentModel.Browsable(false)]
public virtual object this[string keyword] { get; set; }
member this.Item(string) : obj with 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, bunu almaya çalışmak bir ArgumentExceptionoluşturur ve ayarlamaya çalışmak, belirtilen anahtarı kullanarak yeni bir öğe oluşturur.

Null (Visual Basic Nothing) anahtarı geçirilmesi bir ArgumentNullException oluşturur. Null değer atamak anahtar/değer çiftini kaldırır.

Öznitelikler
BrowsableAttribute

Özel durumlar

ArgumentException

değeri keyword koleksiyonda ayarlanmadı.

ArgumentNullException

keyword null başvurudur (Visual Basic Nothing).

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 bir DbConnectionStringBuilder oluşturur ve Item[] özelliğini kullanarak bağlantı dizesi anahtar/değer çiftleri 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.

Şunlara uygulanır

Ayrıca bkz.