SortedList.Item[Object] Właściwość

Odwołanie

Definicja

Przestrzeń nazw:: System.Collections

Zestawy:: mscorlib.dll, System.Collections.NonGeneric.dll

Zestaw:: System.Collections.NonGeneric.dll

Zestaw:: mscorlib.dll

Zestaw:: netstandard.dll

Źródło:: SortedList.cs

Źródło:: SortedList.cs

Źródło:: SortedList.cs

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Pobiera lub ustawia wartość skojarzona z określonym kluczem SortedList w obiekcie.

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; }

public virtual object? this[object key] { get; set; }

member this.Item(obj) : obj with get, set

Default Public Overridable Property Item(key As Object) As Object

Parametry

key: Object

Klucz skojarzony z wartością do pobrania lub ustawienia.

Wartość właściwości

Object

Wartość skojarzona z parametrem keySortedList w obiekcie, jeśli key zostanie znaleziona; w przeciwnym razie null.

Implementuje

Item[Object]

Wyjątki

ArgumentNullException

key to null.

NotSupportedException

Właściwość jest ustawiona SortedList , a obiekt jest tylko do odczytu.

-lub-

Właściwość jest ustawiona, key nie istnieje w kolekcji i SortedList ma stały rozmiar.

OutOfMemoryException

Za mało dostępnej pamięci, aby dodać element do SortedListelementu .

InvalidOperationException

Porównanie zgłasza wyjątek.

Uwagi

Za pomocą Item[] właściwości można uzyskać dostęp do określonego elementu w kolekcji, określając następującą składnię: myCollection[key].

Możesz również użyć tej właściwości, aby dodać nowe elementy, ustawiając wartość klucza, który nie istnieje w SortedList obiekcie (na przykład myCollection["myNonexistentKey"] = myValue). Jeśli jednak określony klucz już istnieje w obiekcie SortedList, ustawienie Item[] właściwości zastępuje starą wartość. Add Natomiast metoda nie modyfikuje istniejących elementów.

Kluczem nie może być null, ale może być wartość. Aby odróżnić wartość zwracaną, null ponieważ określony klucz nie został znaleziony i null zwracany, ponieważ wartość określonego klucza to null, użyj Contains metody lub ContainsKey metody, aby określić, czy klucz istnieje na liście.

Elementy elementu SortedList są sortowane według kluczy zgodnie z określoną implementacją określoną IComparer podczas SortedList tworzenia lub zgodnie z IComparable implementacją podaną przez same klucze.

Język C# używa słowa kluczowego this do definiowania indeksatorów zamiast implementowania Keys właściwości. Visual Basic implementuje Item[] jako właściwość domyślną, która zapewnia tę samą funkcjonalność indeksowania.

Pobieranie wartości tej właściwości jest operacją O(log n) , gdzie n to Count. Ustawienie właściwości jest operacją O(log n) , jeśli klucz znajduje się już w obiekcie SortedList. Jeśli klucz nie znajduje się na liście, ustawienie właściwości jest operacją O(n) dla niesortowanych danych lub O(log n) jeśli nowy element zostanie dodany na końcu listy. Jeśli wstawienie powoduje zmianę rozmiaru, operacja to O(n).

Dotyczy