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

Definicja

Pobiera lub ustawia wartość skojarzoną z określonym kluczem w obiekcie SortedList.Gets or sets the value associated with a specific key in a SortedList object.

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, set
Default Public Overridable Property Item(key As Object) As Object

Parametry

key
Object

Klucz skojarzony z wartością do pobrania lub ustawienia.The key associated with the value to get or set.

Wartość właściwości

Object

Wartość skojarzona z parametrem key w obiekcie SortedList, jeśli key zostanie znaleziona; w przeciwnym razie null.The value associated with the key parameter in the SortedList object, if key is found; otherwise, null.

Implementuje

Wyjątki

Parametr key ma wartość null.key is null.

Właściwość jest ustawiona, a obiekt SortedList jest tylko do odczytu.The property is set and the SortedList object is read-only.

— lub —-or- Właściwość jest ustawiona, key nie istnieje w kolekcji, a SortedList ma stały rozmiar.The property is set, key does not exist in the collection, and the SortedList has a fixed size.

Za mało dostępnej pamięci, aby dodać element do SortedList.There is not enough available memory to add the element to the SortedList.

Funkcja porównująca zgłasza wyjątek.The comparer throws an exception.

Uwagi

Możesz użyć właściwości Item[], aby uzyskać dostęp do określonego elementu w kolekcji, określając następującą składnię: myCollection[key].You can use the Item[] property to access a specific element in a collection by specifying the following syntax: myCollection[key].

Można także użyć tej właściwości do dodawania nowych elementów przez ustawienie wartości klucza, który nie istnieje w obiekcie SortedList (na przykład myCollection["myNonexistentKey"] = myValue).You can also use this property to add new elements by setting the value of a key that does not exist in the SortedList object (for example, myCollection["myNonexistentKey"] = myValue). Jeśli jednak określony klucz już istnieje w SortedList, ustawienie właściwości Item[] zastępuje starą wartość.However, if the specified key already exists in the SortedList, setting the Item[] property overwrites the old value. W przeciwieństwie do metody Add nie są modyfikowane istniejące elementy.In contrast, the Add method does not modify existing elements.

Nie można nullklucza, ale może to być wartość.A key cannot be null, but a value can be. Aby rozróżnić null, które są zwracane, ponieważ określony klucz nie został znaleziony i null zwracane, ponieważ wartość określonego klucza jest null, użyj metody Contains lub metody ContainsKey, aby określić, czy klucz istnieje na liście.To distinguish between null that is returned because the specified key is not found and null that is returned because the value of the specified key is null, use the Contains method or the ContainsKey method to determine if the key exists in the list.

Elementy SortedList są sortowane według kluczy zgodnie z określoną implementacją IComparer określoną podczas tworzenia SortedList lub zgodnie z implementacją IComparableą podaną przez same klucze.The elements of a SortedList are sorted by the keys either according to a specific IComparer implementation specified when the SortedList is created or according to the IComparable implementation provided by the keys themselves.

C# Język używa słowa kluczowego this , aby zdefiniować indeksatory zamiast implementowania właściwości Keys.The C# language uses the this keyword to define the indexers instead of implementing the Keys property. Visual Basic implementuje Item[] jako właściwość domyślną, która zapewnia te same funkcje indeksowania.Visual Basic implements Item[] as a default property, which provides the same indexing functionality.

Pobieranie wartości tej właściwości jest operacją O(log n), gdzie n jest Count.Retrieving the value of this property is an O(log n) operation, where n is Count. Ustawienie właściwości jest operacją O(log n), jeśli klucz jest już w SortedList.Setting the property is an O(log n) operation if the key is already in the 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.If the key is not in the list, setting the property is an O(n) operation for unsorted data, or O(log n) if the new element is added at the end of the list. Jeśli podczas wstawiania zostanie wydana zmiana rozmiaru, operacja jest O(n).If insertion causes a resize, the operation is O(n).

Dotyczy

Zobacz też