TableColumnCollection.Capacity Egenskap
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Hämtar eller anger den förallokerade samlingens objektkapacitet för den här samlingen.
public:
property int Capacity { int get(); void set(int value); };public int Capacity { get; set; }member this.Capacity : int with get, setPublic Property Capacity As IntegerEgenskapsvärde
Den förallokerade samlingens objektkapacitet för den här samlingen. Standardvärdet är 8.
Undantag
Utlöses när ett försök görs att ange Capacity till ett värde som är mindre än det aktuella värdet för Count.
Kommentarer
Egenskapen Capacity representerar antalet förallokerade platser för lagring av objekt i den här samlingen, medan Count egenskapen representerar det faktiska antalet objekt som för närvarande finns i samlingen. Värdet Capacity för är alltid minst lika stort som värdet för Count.
När nyligen tillagda samlingsobjekt gör att samlingsantalet överskrider insamlingskapaciteten ökas kapaciteten automatiskt för att rymma de nyligen tillagda samlingsobjekten. Om du ökar insamlingskapaciteten måste du allokera ytterligare samlingsfack, vilket medför både prestanda och minneskostnader. Använd egenskapen Capacity för att optimera insamlingskapaciteten i de fall då det totala eller maximala antalet samlingsobjekt är känt i förväg. TrimToSize Använd metoden för att få insamlingskapaciteten att utjämnas med det aktuella samlingsantalet.
