Export (0) Print
Expand All

TableRowCollection.Capacity Property

Gets or sets the pre-allocated collection item capacity for this collection.

Namespace:  System.Windows.Documents
Assembly:  PresentationFramework (in PresentationFramework.dll)

public int Capacity { get; set; }

Property Value

Type: System.Int32
The pre-allocated collection item capacity for this collection. The default value is 8.

ExceptionCondition
ArgumentOutOfRangeException

Raised when an attempt is made to set Capacity to a value that is less than the current value of Count.

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.

.NET Framework

Supported in: 4.5.3, 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Show:
© 2014 Microsoft