TableCellCollection.Capacity Özellik

Tanım

Ad Alanı:

System.Windows.Documents

Bütünleştirilmiş Kod:

PresentationFramework.dll

Bu koleksiyon için önceden ayrılmış koleksiyon öğesi kapasitesini alır veya ayarlar.

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. Varsayılan değer 8'dir.

Özel durumlar

ArgumentOutOfRangeException

geçerli Countdeğerinden küçük bir değere ayarlama Capacity girişiminde bulunulduğunda oluşturulur.

Açıklamalar

Capacity özelliği, öğeleri bu koleksiyonda depolamak için önceden ayrılmış yuva sayısını temsil ederkenCount, özelliği şu anda koleksiyonda olan öğelerin gerçek sayısını temsil eder. değeri Capacity her zaman değerinin en az değeri Countkadar büyüktür.

Yeni eklenen koleksiyon öğeleri koleksiyon sayısının koleksiyon kapasitesini aşmasına neden olduğunda, yeni eklenen koleksiyon öğelerini barındırmak için kapasite otomatik olarak artırılır. Koleksiyon kapasitesini artırmak, hem performans hem de bellek yüküne neden olan ek koleksiyon yuvaları ayırmayı içerir. Capacity Toplam veya en fazla koleksiyon öğesi sayısının önceden bilindiği durumlarda koleksiyon kapasitesini iyileştirmek için özelliğini kullanın. TrimToSize Yöntemini kullanarak koleksiyon kapasitesinin geçerli koleksiyon sayısıyla eşitleştirilmesine neden olun.