SortedList.Capacity Właściwość

Definicja

Pobiera lub ustawia pojemność obiektu SortedList.Gets or sets the capacity of a SortedList object.

public:
 virtual property int Capacity { int get(); void set(int value); };
public virtual int Capacity { get; set; }
member this.Capacity : int with get, set
Public Overridable Property Capacity As Integer

Wartość właściwości

Int32

Liczba elementów, które może zawierać obiekt SortedList.The number of elements that the SortedList object can contain.

Wyjątki

Przypisana wartość jest mniejsza niż bieżąca liczba elementów w obiekcie SortedList.The value assigned is less than the current number of elements in the SortedList object.

Za mało dostępnej pamięci w systemie.There is not enough memory available on the system.

Uwagi

Capacity to liczba elementów, które obiekt SortedList może przechowywać.Capacity is the number of elements that the SortedList object can store. Count to liczba elementów, które faktycznie znajdują się w SortedList.Count is the number of elements that are actually in the SortedList.

Capacity jest zawsze większa lub równa Count.Capacity is always greater than or equal to Count. Jeśli Count przekroczy Capacity podczas dodawania elementów, pojemność zostanie automatycznie zwiększona przez ponowne przypisanie tablicy wewnętrznej przed skopiowaniem starych elementów i dodanie nowych elementów.If Count exceeds Capacity while adding elements, the capacity is automatically increased by reallocating the internal array before copying the old elements and adding the new elements.

Wydajność można zmniejszyć, wywołując TrimToSize lub ustawiając właściwość Capacity jawnie.The capacity can be decreased by calling TrimToSize or by setting the Capacity property explicitly. Gdy wartość Capacity jest ustawiona jawnie, tablica wewnętrzna również zostaje przyalokowana ponownie, aby pomieścić określoną pojemność.When the value of Capacity is set explicitly, the internal array is also reallocated to accommodate the specified capacity.

Pobieranie wartości tej właściwości jest operacją O(1); ustawienie właściwości jest operacją O(n), gdzie n jest nową pojemnością.Retrieving the value of this property is an O(1) operation; setting the property is an O(n) operation, where n is the new capacity.

Dotyczy

Zobacz też