Freigeben über


NameValueCollection-Konstruktor (Int32)

Initialisiert eine neue, leere Instanz der NameValueCollection-Klasse mit der angegebenen Anfangskapazität, wobei der Hashcode-Standardanbieter und der Standardcomparer verwendet werden, die beide die Groß- und Kleinschreibung nicht berücksichtigen.

Namespace: System.Collections.Specialized
Assembly: System (in system.dll)

Syntax

'Declaration
Public Sub New ( _
    capacity As Integer _
)
'Usage
Dim capacity As Integer

Dim instance As New NameValueCollection(capacity)
public NameValueCollection (
    int capacity
)
public:
NameValueCollection (
    int capacity
)
public NameValueCollection (
    int capacity
)
public function NameValueCollection (
    capacity : int
)

Parameter

Ausnahmen

Ausnahmetyp Bedingung

ArgumentOutOfRangeException

capacity ist kleiner als 0 (null).

Hinweise

Bei der Kapazität einer NameValueCollection handelt es sich um die Anzahl der Elemente, die die NameValueCollection enthalten kann. Wenn Elemente einer NameValueCollection hinzugefügt werden, wird durch die Neuzuordnung des internen Arrays die Kapazität automatisch nach Bedarf erhöht.

Sofern die Größe der Auflistung geschätzt werden kann, entfallen durch die Angabe der anfänglichen Kapazität einige Operationen zum Ändern der Größe, die sonst beim Hinzufügen von Elementen zum NameValueCollection durchgeführt werden müssen.

Der Hashcodeanbieter verteilt Hashcodes für Schlüssel in der NameValueCollection. Der Hashcode-Standardanbieter ist CaseInsensitiveHashCodeProvider.

Der Comparer ermittelt, ob zwei Schlüssel gleich sind. Der Standardcomparer ist CaseInsensitiveComparer.

Dieser Konstruktor ist eine O(n)-Operation, wobei n die capacity ist.

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

NameValueCollection-Klasse
NameValueCollection-Member
System.Collections.Specialized-Namespace
CaseInsensitiveHashCodeProvider-Klasse
CaseInsensitiveComparer-Klasse

Weitere Ressourcen

Durchführen kulturunabhängiger Zeichenfolgenoperationen