NameValueCollection-Konstruktor (Int32, NameValueCollection)

Kopiert die Einträge aus der angegebenen NameValueCollection in eine neue NameValueCollection mit der angegebenen Anfangskapazität bzw. mit einer Anfangskapazität, die der Anzahl der kopierten Einträge entspricht, je nachdem, welche größer ist. Es werden der Hashcode-Standardanbieter und der Standardcomparer verwendet, die die Groß- und Kleinschreibung nicht berücksichtigen.

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

Syntax

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

Dim instance As New NameValueCollection(capacity, col)

public NameValueCollection (
    int capacity,
    NameValueCollection col
)

public:
NameValueCollection (
    int capacity, 
    NameValueCollection^ col
)

public NameValueCollection (
    int capacity, 
    NameValueCollection col
)

public function NameValueCollection (
    capacity : int, 
    col : NameValueCollection
)

Parameter

• capacity
  Die anfängliche Anzahl von Einträgen, die NameValueCollection enthalten kann.

• col
  Die NameValueCollection, die in die neue NameValueCollection-Instanz kopiert werden soll.

Ausnahmen

Ausnahmetyp	Bedingung
ArgumentOutOfRangeException	capacity ist kleiner als 0 (null).
ArgumentNullException	col ist NULL (Nothing in Visual Basic).

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. Falls die Anzahl der Elemente in col größer ist als capacity, wird dieser Konstruktor zu einer O(n + m)-Operation, wobei n die capacity ist und m die Anzahl der Elemente in col 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