TableColumnCollection.Capacity Özellik

Tanım

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

Bu koleksiyon için önceden ayrılmış koleksiyon öğesi kapasitesi. Varsayılan değer 8'dir.

Özel durumlar

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

Açıklamalar

Capacity özelliği, öğeleri bu koleksiyonda depolamak için önceden ayrılmış yuva sayısını temsil ederkenCount, özellik şu anda koleksiyondaki öğ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, kapasite yeni eklenen koleksiyon öğelerini barındıracak şekilde otomatik olarak artırılır. Koleksiyon kapasitesini artırmak için ek koleksiyon yuvaları ayrılır ve bu da hem performans hem de bellek yüküne neden olur. 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. Koleksiyon kapasitesinin TrimToSize geçerli koleksiyon sayısıyla eşitlenmiş olmasını sağlamak için yöntemini kullanın.

Şunlara uygulanır

Ayrıca bkz.