DbConnectionStringBuilder.Item[String] Eigenschaft

Referenz

Definition

Namespace:: System.Data.Common

Assembly:: System.Data.Common.dll

Assembly:: System.Data.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft den Wert ab, der dem angegebenen Schlüssel zugeordnet ist, oder legt diesen fest.

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

Parameter

keyword: String

Der Schlüssel des abzurufenden oder festzulegenden Elements.

Eigenschaftswert

Object

Der dem angegebenen Schlüssel zugeordnete Wert. Wenn der angegebene Schlüssel nicht gefunden werden kann, wird beim Abrufen dieses Schlüssels ein Nullverweis (Nothing in Visual Basic) zurückgegeben, und beim Festlegen wird ein neues Element mit dem angegebenen Schlüssel erstellt.

Beim Übergeben eines Nullschlüssels (Nothing in Visual Basic) wird eine ArgumentNullException ausgelöst. Durch Zuweisen eines NULL-Werts wird das Schlüssel-Wert-Paar entfernt.

Attribute: BrowsableAttribute

Ausnahmen

ArgumentNullException

keyword ist ein NULL-Verweis (Nothing in Visual Basic).

NotSupportedException

Die Eigenschaft wird festgelegt, und der DbConnectionStringBuilder ist schreibgeschützt.

- oder -

Die Eigenschaft wird festgelegt, keyword ist in der Auflistung nicht vorhanden, und der DbConnectionStringBuilder hat eine feste Größe.

Beispiele

Die folgende Konsolenanwendung erstellt ein neues DbConnectionStringBuilder Und fügt die Verbindungszeichenfolge mithilfe der Item[] Eigenschaft schlüssel/wertpaare hinzu.

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

Hinweise

Wenn Sie diese Eigenschaft festlegen, wenn der angegebene Schlüssel bereits im Wörterbuch vorhanden ist, wird der Wert ersetzt; andernfalls wird ein neues Element erstellt.

Gilt für