DbConnectionStringBuilder.Item[String] Właściwość
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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); };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, setDefault Public Overridable Property Item(keyword As String) As ObjectParametry
- keyword
- String
Klucz elementu do pobrania lub ustawienia.
Wartość właściwości
Wartość skojarzona z określonym kluczem. Jeśli określony klucz nie zostanie znaleziony ArgumentException, próba jego pobrania spowoduje zgłoszenie elementu i próba ustawienia go spowoduje utworzenie nowego elementu przy użyciu określonego klucza.
Przekazywanie klucza o wartości null (Nothing w Visual Basic) zgłasza ArgumentNullException. Przypisanie wartości null spowoduje usunięcie pary klucz/wartość.
- Atrybuty
Wyjątki
Wartość elementu keyword nie została ustawiona w kolekcji.
keyword jest odwołaniem o wartości null (Nothing w Visual Basic).
Właściwość jest ustawiona, a DbConnectionStringBuilder właściwość 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 nową DbConnectionStringBuilder i dodaje pary klucz/wartość do parametry połączenia przy użyciu właściwości Item[].
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.
