Hashtable.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 de waarde op die is gekoppeld aan de opgegeven sleutel of stelt u deze in.
public:
virtual property System::Object ^ default[System::Object ^] { System::Object ^ get(System::Object ^ key); void set(System::Object ^ key, System::Object ^ value); };public virtual object this[object key] { get; set; }member this.Item(obj) : obj with get, setDefault Public Overridable Property Item(key As Object) As ObjectParameters
- key
- Object
De sleutel waarvan de waarde moet worden opgehaald of ingesteld.
Waarde van eigenschap
De waarde die is gekoppeld aan de opgegeven sleutel. Als de opgegeven sleutel niet wordt gevonden, wordt geprobeerd deze terug nullte krijgen en wordt er een nieuw element gemaakt met behulp van de opgegeven sleutel.
Implementeringen
Uitzonderingen
key is null.
De eigenschap is ingesteld en de eigenschap heeft het Hashtable kenmerk Alleen-lezen.
– of –
De eigenschap is ingesteld, key bestaat niet in de verzameling en de Hashtable eigenschap heeft een vaste grootte.
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 Hashtable; bijvoorbeeld myCollection["myNonexistentKey"] = myValue. Als de opgegeven sleutel echter al bestaat in de Hashtableeigenschap, wordt de oude waarde overschreven door de Item[] eigenschap in te stellen. De methode wijzigt daarentegen Add geen bestaande elementen.
Een sleutel kan niet zijn null, maar een waarde kan zijn. Als u onderscheid wilt maken tussen null die sleutel omdat de opgegeven sleutel niet wordt gevonden en null die wordt geretourneerd omdat de waarde van de opgegeven sleutel is null, gebruikt u de Contains methode of de ContainsKey methode om te bepalen of de sleutel in de lijst aanwezig is.
Het ophalen van de waarde van deze eigenschap is een O(1) bewerking; het instellen van de eigenschap is ook een O(1) bewerking.
De C#-taal gebruikt het this 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.