TableRowGroupCollection.Capacity Özellik

Tanım

Bu koleksiyon için önceden ayrılmış koleksiyon öğesi kapasitesini alır veya ayarlar.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

Özellik Değeri

Int32

Bu koleksiyon için önceden ayrılmış koleksiyon öğesi kapasitesi.The pre-allocated collection item capacity for this collection. Varsayılan değer 8' dir.The default value is 8.

Özel durumlar

CapacityGeçerli değerinden küçük bir değere ayarlamak için bir deneme yapıldığında tetiklenir Count .Raised when an attempt is made to set Capacity to a value that is less than the current value of Count.

Açıklamalar

CapacityÖzelliği, bu koleksiyonda öğeleri depolamak için önceden ayrılmış yuvaların sayısını temsil eder, ancak Count özellik koleksiyonda bulunan gerçek öğe sayısını temsil eder.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. Değeri Capacity her zaman değeri olarak en az olur Count .The value of Capacity is always at least as large as the value of Count.

Yeni eklenen koleksiyon öğeleri koleksiyon sayısının koleksiyon kapasitesini aşmasına neden olduğunda, kapasite yeni eklenen koleksiyon öğelerine uyacak şekilde otomatik olarak artar.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. Koleksiyon kapasitesini artırmak, hem performans hem de bellek yükünü içeren ek koleksiyon yuvaları ayırmayı içerir.Increasing the collection capacity involves allocating additional collection slots, which incurs both performance and memory overhead. CapacityKoleksiyon öğelerinin toplam veya maksimum sayısı önceden bilinen olduğu durumlarda koleksiyon kapasitesini iyileştirmek için özelliğini kullanın.Use the Capacity property to optimize the collection capacity in cases where the total or maximum number of collection items is known in advance. TrimToSizeKoleksiyon kapasitesini geçerli koleksiyon sayısıyla eşit hale gelmesine neden olmak için yöntemini kullanın.Use the TrimToSize method to cause the collection capacity to equalized with the current collection count.

Şunlara uygulanır

Ayrıca bkz.