SortedList.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 een specifieke sleutel in een SortedList object 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 die is gekoppeld aan de waarde die moet worden opgehaald of ingesteld.
Waarde van eigenschap
De waarde die is gekoppeld aan de key parameter in het SortedList object, indien key gevonden; anders. null
Implementeringen
Uitzonderingen
key is null.
De eigenschap is ingesteld en het object heeft het SortedList kenmerk Alleen-lezen.
– of –
De eigenschap is ingesteld, key bestaat niet in de verzameling en de SortedList eigenschap heeft een vaste grootte.
Er is onvoldoende geheugen beschikbaar om het element toe te voegen aan de SortedList.
De vergelijkingsfunctie genereert een uitzondering.
Opmerkingen
U kunt de Item[] eigenschap gebruiken om toegang te krijgen tot een specifiek element in een verzameling door de volgende syntaxis op te geven: myCollection[key]
U kunt deze eigenschap ook gebruiken om nieuwe elementen toe te voegen door de waarde in te stellen van een sleutel die niet bestaat in het SortedList object (bijvoorbeeld myCollection["myNonexistentKey"] = myValue). Als de opgegeven sleutel echter al bestaat in de SortedListeigenschap, 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.
De elementen van een worden SortedList gesorteerd op de sleutels volgens een specifieke IComparer implementatie die is opgegeven bij het SortedList maken of volgens de IComparable implementatie die door de sleutels zelf wordt verstrekt.
De C#-taal gebruikt het this trefwoord om de indexeerfuncties te definiëren in plaats van de Keys eigenschap te implementeren. Visual Basic implementeert Item[] als een standaardeigenschap, die dezelfde indexeringsfunctionaliteit biedt.
Het ophalen van de waarde van deze eigenschap is een O(log n) bewerking, waarbij n .Count Het instellen van de eigenschap is een O(log n) bewerking als de sleutel zich al in de SortedList. Als de sleutel zich niet in de lijst bevindt, is het instellen van de eigenschap een O(n) bewerking voor niet-gesorteerde gegevens of O(log n) als het nieuwe element wordt toegevoegd aan het einde van de lijst. Als de invoeging een grootte veroorzaakt, is O(n)de bewerking .