TableRowGroupCollection.Capacity Özellik
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
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.