DbConnectionStringBuilder.Item[String] Tulajdonság

Definíció

Névtér:
System.Data.Common
Szerelvény:
System.Data.Common.dll
Szerelvények:
netstandard.dll, System.Data.Common.dll
Szerelvény:
System.Data.dll
Szerelvény:
netstandard.dll
Forrás:
DbConnectionStringBuilder.cs
Forrás:
DbConnectionStringBuilder.cs
Forrás:
DbConnectionStringBuilder.cs
Forrás:
DbConnectionStringBuilder.cs
Forrás:
DbConnectionStringBuilder.cs

Lekéri vagy beállítja a megadott kulccsal társított értéket.

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

Paraméterek

keyword
String

A lekérni vagy beállítani kívánt elem kulcsa.

Tulajdonság értéke

Object

A megadott kulccsal társított érték. Ha a megadott kulcs nem található, a lekérés megkísérlése egy ArgumentException, majd a beállítás megkísérlése új elemet hoz létre a megadott kulccsal.

Null (Nothing Visual Basic) billentyű átadásával ArgumentNullException. A null érték hozzárendelése eltávolítja a kulcs/érték párot.

Attribútumok
BrowsableAttribute

Kivételek

ArgumentException

Az érték keyword nincs beállítva a gyűjteményben.

ArgumentNullException

keyword null értékű hivatkozás (Nothing Visual Basic).

NotSupportedException

A tulajdonság be van állítva, és az DbConnectionStringBuilder írásvédett.

-vagy-

A tulajdonság be van állítva, keyword nem létezik a gyűjteményben, és rögzített DbConnectionStringBuilder méretű.

Példák

A következő konzolalkalmazás egy új DbConnectionStringBuilder hoz létre, és a Item[] tulajdonság használatával kulcs-/érték párokat ad hozzá a kapcsolati karakterlánc.

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

Megjegyzések

A tulajdonság beállításakor, ha a megadott kulcs már létezik a szótárban, a rendszer lecseréli az értéket; ellenkező esetben egy új elem jön létre.

A következőre érvényes:

Lásd még