DbConnectionStringBuilder.Item[String] Właściwość

Definicja

Przestrzeń nazw:

System.Data.Common

Zestaw:

System.Data.Common.dll

Źródło:

DbConnectionStringBuilder.cs

Pobiera lub ustawia wartość skojarzona z określonym kluczem.

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

Parametry

keyword

String

Klucz elementu do pobrania lub ustawienia.

Wartość właściwości

Object

Wartość skojarzona z określonym kluczem. Jeśli określony klucz nie zostanie znaleziony, próba pobrania go zwróci odwołanie o wartości null (Nothing w języku Visual Basic) i próbuje ustawić, aby utworzyć nowy element przy użyciu określonego klucza.

Przekazanie klucza null (Nothing w Visual Basic) zgłasza błąd ArgumentNullException. Przypisanie wartości null spowoduje usunięcie pary klucz/wartość.

Atrybuty

BrowsableAttribute

Wyjątki

ArgumentNullException

keyword jest odwołaniem o wartości null (Nothing w Visual Basic).

NotSupportedException

Właściwość jest ustawiona, a właściwość DbConnectionStringBuilder jest tylko do odczytu.

-lub-

Właściwość jest ustawiona, keyword nie istnieje w kolekcji i DbConnectionStringBuilder ma stały rozmiar.

Przykłady

Poniższa aplikacja konsolowa tworzy nowe DbConnectionStringBuilder i dodaje pary klucz/wartość do jej parametry połączenia przy użyciu Item[] właściwości .

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

Uwagi

Po ustawieniu tej właściwości, jeśli określony klucz już istnieje w słowniku, wartość zostanie zamieniona; w przeciwnym razie zostanie utworzony nowy element.

Zobacz też

• Parametry połączenia w ADO.NET
• Omówienie ADO.NET