DbConnectionStringBuilder.Item[String] Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee haalt u de waarde op die is gekoppeld aan de opgegeven sleutel of stelt u deze in.
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 ObjectParameters
- keyword
- String
De sleutel van het item dat u wilt ophalen of instellen.
Waarde van eigenschap
De waarde die is gekoppeld aan de opgegeven sleutel. Als de opgegeven sleutel niet wordt gevonden, wordt er geprobeerd ArgumentExceptioneen te genereren en wordt er een nieuw element gemaakt met behulp van de opgegeven sleutel.
Het doorgeven van een null-toets (Nothing in Visual Basic) genereert een ArgumentNullException. Als u een null-waarde toewijst, wordt het sleutel-/waardepaar verwijderd.
- Kenmerken
Uitzonderingen
De waarde voor deze keyword waarde is niet ingesteld in de verzameling.
keyword is een null-verwijzing (Nothing in Visual Basic).
De eigenschap is ingesteld en de eigenschap heeft het DbConnectionStringBuilder kenmerk Alleen-lezen.
– of –
De eigenschap is ingesteld, keyword bestaat niet in de verzameling en de DbConnectionStringBuilder eigenschap heeft een vaste grootte.
Voorbeelden
De volgende consoletoepassing maakt een nieuwe DbConnectionStringBuilder en voegt sleutel-waardeparen toe aan de verbindingsreeks, met behulp van de eigenschap 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
Opmerkingen
Wanneer u deze eigenschap instelt en de opgegeven sleutel al in de woordenlijst bestaat, wordt de waarde vervangen; anders wordt er een nieuw element gemaakt.