SortedList.Item[Object] Egenskap
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Hämtar eller anger värdet som är associerat med en specifik nyckel i ett SortedList objekt.
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 ObjectParametrar
- key
- Object
Nyckeln som är associerad med värdet som ska hämtas eller anges.
Egenskapsvärde
Värdet som är associerat med parametern keySortedList i objektet, om key det hittas, annars null.
Implementeringar
Undantag
key är null.
Egenskapen har angetts och objektet SortedList är skrivskyddat.
-eller-
Egenskapen har angetts, key finns inte i samlingen och SortedList har en fast storlek.
Det finns inte tillräckligt med ledigt minne för att lägga till elementet i SortedList.
Jämförelsen genererar ett undantag.
Kommentarer
Du kan använda egenskapen Item[] för att komma åt ett visst element i en samling genom att ange följande syntax: myCollection[key].
Du kan också använda den här egenskapen för att lägga till nya element genom att ange värdet för en nyckel som inte finns i SortedList objektet (till exempel myCollection["myNonexistentKey"] = myValue). Men om den angivna nyckeln redan finns i SortedList, skriver egenskapen Item[] över det gamla värdet. Metoden ändrar däremot Add inte befintliga element.
En nyckel kan inte vara null, men ett värde kan vara. Om du vill skilja mellan null det returneras eftersom den angivna nyckeln inte hittas och null som returneras eftersom värdet för den angivna nyckeln är nullanvänder du Contains metoden eller ContainsKey metoden för att avgöra om nyckeln finns i listan.
Elementen i en SortedList sorteras efter nycklarna antingen enligt en specifik IComparer implementering som anges när SortedList den skapas eller enligt implementeringen IComparable som tillhandahålls av själva nycklarna.
C#-språket använder nyckelordet this för att definiera indexerarna i stället för att Keys implementera egenskapen. Visual Basic implementerar Item[] som en standardegenskap, vilket ger samma indexeringsfunktioner.
Att hämta värdet för den här egenskapen är en O(log n) åtgärd, där n är Count. Att ange egenskapen är en O(log n) åtgärd om nyckeln redan finns i SortedList. Om nyckeln inte finns i listan är inställningen för egenskapen en O(n) åtgärd för osorterade data, eller O(log n) om det nya elementet läggs till i slutet av listan. Om infogning orsakar en storleksändring är O(n)åtgärden .