NameValueCollection-Konstruktor (Int32, IHashCodeProvider, IComparer)

HINWEIS: Dieser Konstruktor ist mittlerweile veraltet.

Initialisiert eine neue, leere Instanz der NameValueCollection-Klasse mit der angegebenen Anfangskapazität, wobei der angegebene Hashcodeanbieter und Comparer verwendet werden.

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

Syntax

'Declaration
<ObsoleteAttribute("Please use NameValueCollection(Int32, IEqualityComparer) instead.")> _
Public Sub New ( _
    capacity As Integer, _
    hashProvider As IHashCodeProvider, _
    comparer As IComparer _
)
'Usage
Dim capacity As Integer
Dim hashProvider As IHashCodeProvider
Dim comparer As IComparer

Dim instance As New NameValueCollection(capacity, hashProvider, comparer)

[ObsoleteAttribute("Please use NameValueCollection(Int32, IEqualityComparer) instead.")] 
public NameValueCollection (
    int capacity,
    IHashCodeProvider hashProvider,
    IComparer comparer
)

[ObsoleteAttribute(L"Please use NameValueCollection(Int32, IEqualityComparer) instead.")] 
public:
NameValueCollection (
    int capacity, 
    IHashCodeProvider^ hashProvider, 
    IComparer^ comparer
)

/** @attribute ObsoleteAttribute("Please use NameValueCollection(Int32, IEqualityComparer) instead.") */ 
public NameValueCollection (
    int capacity, 
    IHashCodeProvider hashProvider, 
    IComparer comparer
)

ObsoleteAttribute("Please use NameValueCollection(Int32, IEqualityComparer) instead.") 
public function NameValueCollection (
    capacity : int, 
    hashProvider : IHashCodeProvider, 
    comparer : IComparer
)

Parameter

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

• hashProvider
  Der IHashCodeProvider, der die Hashcodes für sämtliche Schlüssel in NameValueCollection bereitstellt.

• comparer
  Der IComparer, mit dem ermittelt wird, ob zwei Schlüssel gleich sind.

Ausnahmen

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: 1.0, 1.1
Veraltet (Compilerwarnung) in 2.0

.NET Compact Framework

Unterstützt in: 1.0
Veraltet (Compilerwarnung) in 2.0

Siehe auch

Referenz

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

Weitere Ressourcen

Durchführen kulturunabhängiger Zeichenfolgenoperationen