TableRowGroupCollection.Capacity Property
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Gets or sets the pre-allocated collection item capacity for this collection.
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
Property Value
The pre-allocated collection item capacity for this collection. The default value is 8.
Exceptions
Raised when an attempt is made to set Capacity to a value that is less than the current value of Count.
Remarks
The Capacity property represents the number of pre-allocated slots for storing items in this collection, whereas the Count property represents the actual number of items currently in the collection. The value of Capacity is always at least as large as the value of Count.
When newly added collection items cause the collection count to exceed the collection capacity, the capacity is automatically increased to accommodate the newly added collection items. Increasing the collection capacity involves allocating additional collection slots, which incurs both performance and memory overhead. Use the Capacity property to optimize the collection capacity in cases where the total or maximum number of collection items is known in advance. Use the TrimToSize method to cause the collection capacity to equalized with the current collection count.
Applies to
See also
.NET
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기