SortedList<TKey,TValue>.Capacity Właściwość

Definicja

Przestrzeń nazw:

System.Collections.Generic

Zestaw:

System.Collections.dll

Źródło:

SortedList.cs

Pobiera lub ustawia liczbę elementów, które SortedList<TKey,TValue> mogą zawierać.

public:
 property int Capacity { int get(); void set(int value); };

public int Capacity { get; set; }

member this.Capacity : int with get, set

Public Property Capacity As Integer

Wartość właściwości

Int32

Liczba elementów, które SortedList<TKey,TValue> mogą zawierać.

Wyjątki

ArgumentOutOfRangeException

Capacity jest ustawiona na wartość mniejszą niż Count.

OutOfMemoryException

W systemie jest za mało dostępnej pamięci.

Uwagi

Capacity jest liczbą elementów, które SortedList<TKey,TValue> mogą być przechowywane. Count to liczba elementów, które są rzeczywiście w elemecie SortedList<TKey,TValue>.

Capacity wartość jest zawsze większa niż lub równa Count. Jeśli Count podczas dodawania elementów zostanie przekroczona Capacity , pojemność zostanie zwiększona przez automatyczne cofnięcie przydziału tablicy wewnętrznej przed skopiowaniem starych elementów i dodaniem nowych elementów.

Pojemność można zmniejszyć przez wywołanie TrimExcess lub jawne ustawienie Capacity właściwości. Gdy wartość Capacity jest ustawiana jawnie, tablica wewnętrzna jest również przydzielana w celu dostosowania do określonej pojemności.

Pobieranie wartości tej właściwości jest operacją O(1); ustawienie właściwości to operacja O(n), gdzie n jest nową pojemnością.

Zobacz też

• Count
• TrimExcess()