IDictionary.Item[Object] 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 het element op of stelt u het in met de opgegeven sleutel.
public:
property System::Object ^ default[System::Object ^] { System::Object ^ get(System::Object ^ key); void set(System::Object ^ key, System::Object ^ value); };public object this[object key] { get; set; }member this.Item(obj) : obj with get, setDefault Public Property Item(key As Object) As ObjectParameters
- key
- Object
De sleutel van het element dat moet worden get of ingesteld.
Waarde van eigenschap
Het element met de opgegeven sleutel of null als de sleutel niet bestaat.
Uitzonderingen
key is null.
De eigenschap is ingesteld en het object heeft het IDictionary kenmerk Alleen-lezen.
– of –
De eigenschap is ingesteld, key bestaat niet in de verzameling en de IDictionary eigenschap heeft een vaste grootte.
Voorbeelden
In het volgende codevoorbeeld ziet u hoe u de Item[] eigenschap implementeert. Dit codevoorbeeld maakt deel uit van een groter voorbeeld voor de IDictionary klasse.
public object this[object key]
{
get
{
// If this key is in the dictionary, return its value.
Int32 index;
if (TryGetIndexOfKey(key, out index))
{
// The key was found; return its value.
return items[index].Value;
}
else
{
// The key was not found; return null.
return null;
}
}
set
{
// If this key is in the dictionary, change its value.
Int32 index;
if (TryGetIndexOfKey(key, out index))
{
// The key was found; change its value.
items[index].Value = value;
}
else
{
// This key is not in the dictionary; add this key/value pair.
Add(key, value);
}
}
}
Public Property Item(ByVal key As Object) As Object Implements IDictionary.Item
Get
' If this key is in the dictionary, return its value.
Dim index As Integer
If TryGetIndexOfKey(key, index) Then
' The key was found return its value.
Return items(index).Value
Else
' The key was not found return null.
Return Nothing
End If
End Get
Set(ByVal value As Object)
' If this key is in the dictionary, change its value.
Dim index As Integer
If TryGetIndexOfKey(key, index) Then
' The key was found change its value.
items(index).Value = value
Else
' This key is not in the dictionary add this key/value pair.
Add(key, value)
End If
End Set
End Property
Opmerkingen
Deze eigenschap biedt de mogelijkheid om toegang te krijgen tot een specifiek element in de verzameling met behulp van de volgende syntaxis: myCollection[key]
U kunt de Item[] eigenschap ook gebruiken om nieuwe elementen toe te voegen door de waarde in te stellen van een sleutel die niet bestaat in de woordenlijst (bijvoorbeeld myCollection["myNonexistentKey"] = myValue). Als de opgegeven sleutel echter al bestaat in de woordenlijst, wordt de oude waarde overschreven door de Item[] eigenschap in te stellen. De methode wijzigt daarentegen Add geen bestaande elementen.
Implementaties kunnen variëren in of ze de sleutel toestaan.null
De C#-taal gebruikt ditthis trefwoord om de indexeerfuncties te definiëren in plaats van de Item[] eigenschap te implementeren. Visual Basic implementeert Item[] als een standaardeigenschap, die dezelfde indexeringsfunctionaliteit biedt.