NameValueCollection 构造函数

  • 参考

定义

命名空间:
System.Collections.Specialized
程序集:
System.dll, System.Collections.Specialized.dll
程序集:
System.Collections.Specialized.dll
程序集:
System.dll
程序集:
netstandard.dll

初始化 NameValueCollection 类的新实例。

重载

NameValueCollection()

初始化 NameValueCollection 类的新实例，该实例为空且具有默认初始容量，并使用不区分大小写的默认哈希代码提供程序和不区分大小写的默认比较器。
NameValueCollection(IEqualityComparer)

初始化 NameValueCollection 类的新实例，该实例为空、具有默认的初始容量并使用指定的 IEqualityComparer 对象。
NameValueCollection(NameValueCollection)

将项从指定的 NameValueCollection 复制到一个新的 NameValueCollection，这个新集合的初始容量与复制的项数相等，并使用与源集合相同的哈希代码提供程序和比较器。
NameValueCollection(Int32)

初始化 NameValueCollection 类的新实例，该实例为空且具有指定的初始容量，并使用不区分大小写的默认哈希代码提供程序和不区分大小写的默认比较器。
NameValueCollection(IHashCodeProvider, IComparer)
已过时.
已过时.

初始化 NameValueCollection 类的新实例，该实例为空且具有默认初始容量，并使用指定的哈希代码提供程序和指定的比较器。
NameValueCollection(Int32, IEqualityComparer)

初始化 NameValueCollection 类的新实例，该实例为空、具有指定的初始容量并使用指定的 IEqualityComparer 对象。
NameValueCollection(Int32, NameValueCollection)

将项从指定的 NameValueCollection 复制到一个新的 NameValueCollection，这个新集合使用指定的初始容量或与具有与复制的项数相等的初始容量（两者中较大的一个），并使用不区分大小写的默认哈希代码提供程序和不区分大小写的默认比较器。
NameValueCollection(SerializationInfo, StreamingContext)
已过时.

初始化 NameValueCollection 类的新实例，该实例可序列化且使用指定的 SerializationInfo 和 StreamingContext。
NameValueCollection(Int32, IHashCodeProvider, IComparer)
已过时.
已过时.

初始化 NameValueCollection 类的新实例，该实例为空且具有指定的初始容量，并使用指定的哈希代码提供程序和指定的比较器。

NameValueCollection()

Source:
NameValueCollection.cs
Source:
NameValueCollection.cs
Source:
NameValueCollection.cs

初始化 NameValueCollection 类的新实例，该实例为空且具有默认初始容量，并使用不区分大小写的默认哈希代码提供程序和不区分大小写的默认比较器。

public:
 NameValueCollection();
public NameValueCollection ();
Public Sub New ()

注解

的 NameValueCollection 容量是 可以容纳的元素 NameValueCollection 数。 当元素添加到 时 NameValueCollection，容量会根据需要通过重新分配内部数组自动增加。

如果可以估计集合的大小，则指定初始容量就无需在向 中添加元素 NameValueCollection时执行大量调整大小操作。

哈希代码提供程序为 中的 NameValueCollection键分配哈希代码。 默认哈希代码提供程序为 CaseInsensitiveHashCodeProvider。

比较器确定两个键是否相等。 默认比较器为 CaseInsensitiveComparer。

此构造函数是一个 O (1) 操作。

另请参阅

适用于

NameValueCollection(IEqualityComparer)

Source:
NameValueCollection.cs
Source:
NameValueCollection.cs
Source:
NameValueCollection.cs

初始化 NameValueCollection 类的新实例，该实例为空、具有默认的初始容量并使用指定的 IEqualityComparer 对象。

public:
 NameValueCollection(System::Collections::IEqualityComparer ^ equalityComparer);
public NameValueCollection (System.Collections.IEqualityComparer equalityComparer);
public NameValueCollection (System.Collections.IEqualityComparer? equalityComparer);
new System.Collections.Specialized.NameValueCollection : System.Collections.IEqualityComparer -> System.Collections.Specialized.NameValueCollection
Public Sub New (equalityComparer As IEqualityComparer)

参数

equalityComparer
IEqualityComparer

IEqualityComparer 对象，用于确定两个键是否相等，并为集合中的键生成哈希代码。

注解

对象的容量 NameValueCollection 是 可以容纳的元素 NameValueCollection 数。 当元素添加到 时 NameValueCollection，容量会根据需要通过重新分配内部数组自动增加。

如果可以估计集合的大小，则指定初始容量就无需在向 中添加元素 NameValueCollection时执行大量调整大小操作。

对象 IEqualityComparer 将比较器和哈希代码提供程序组合在一起。 哈希代码提供程序为 中的 NameValueCollection键分配哈希代码。 比较器确定两个键是否相等。

此构造函数是一个 O (1) 操作。

另请参阅

适用于

NameValueCollection(NameValueCollection)

Source:
NameValueCollection.cs
Source:
NameValueCollection.cs
Source:
NameValueCollection.cs

将项从指定的 NameValueCollection 复制到一个新的 NameValueCollection，这个新集合的初始容量与复制的项数相等，并使用与源集合相同的哈希代码提供程序和比较器。

public:
 NameValueCollection(System::Collections::Specialized::NameValueCollection ^ col);
public NameValueCollection (System.Collections.Specialized.NameValueCollection col);
new System.Collections.Specialized.NameValueCollection : System.Collections.Specialized.NameValueCollection -> System.Collections.Specialized.NameValueCollection
Public Sub New (col As NameValueCollection)

参数

col
NameValueCollection

要复制到新 NameValueCollection 实例的 NameValueCollection。

例外

ArgumentNullException

col 为 null。

注解

的 NameValueCollection 容量是 可以容纳的元素 NameValueCollection 数。 当元素添加到 时 NameValueCollection，容量会根据需要通过重新分配内部数组自动增加。

如果可以估计集合的大小，则指定初始容量就无需在向 中添加元素 NameValueCollection时执行大量调整大小操作。

哈希代码提供程序为 中的 NameValueCollection键分配哈希代码。 默认哈希代码提供程序为 CaseInsensitiveHashCodeProvider。

比较器确定两个键是否相等。 默认比较器为 CaseInsensitiveComparer。

新 NameValueCollection 元素的排序顺序与源 NameValueCollection相同。

此构造函数是一个 O (n) 操作，其中 n 是 中的 col元素数。

另请参阅

适用于

NameValueCollection(Int32)

Source:
NameValueCollection.cs
Source:
NameValueCollection.cs
Source:
NameValueCollection.cs

初始化 NameValueCollection 类的新实例，该实例为空且具有指定的初始容量，并使用不区分大小写的默认哈希代码提供程序和不区分大小写的默认比较器。

public:
 NameValueCollection(int capacity);
public NameValueCollection (int capacity);
new System.Collections.Specialized.NameValueCollection : int -> System.Collections.Specialized.NameValueCollection
Public Sub New (capacity As Integer)

参数

capacity
Int32

NameValueCollection 可包含的初始项数。

例外

ArgumentOutOfRangeException

capacity 小于零。

注解

的 NameValueCollection 容量是 可以容纳的元素 NameValueCollection 数。 当元素添加到 时 NameValueCollection，容量会根据需要通过重新分配内部数组自动增加。

如果可以估计集合的大小，则指定初始容量就无需在向 中添加元素 NameValueCollection时执行大量调整大小操作。

哈希代码提供程序为 中的 NameValueCollection键分配哈希代码。 默认哈希代码提供程序为 CaseInsensitiveHashCodeProvider。

比较器确定两个键是否相等。 默认比较器为 CaseInsensitiveComparer。

此构造函数是 O (n) 操作，其中 n 为 capacity。

另请参阅

适用于

NameValueCollection(IHashCodeProvider, IComparer)

Source:
NameValueCollection.cs
Source:
NameValueCollection.cs
Source:
NameValueCollection.cs

注意

Please use NameValueCollection(IEqualityComparer) instead.

注意

This constructor has been deprecated. Use NameValueCollection(IEqualityComparer) instead.

初始化 NameValueCollection 类的新实例，该实例为空且具有默认初始容量，并使用指定的哈希代码提供程序和指定的比较器。

public:
 NameValueCollection(System::Collections::IHashCodeProvider ^ hashProvider, System::Collections::IComparer ^ comparer);
[System.Obsolete("Please use NameValueCollection(IEqualityComparer) instead.")]
public NameValueCollection (System.Collections.IHashCodeProvider? hashProvider, System.Collections.IComparer? comparer);
[System.Obsolete("This constructor has been deprecated. Use NameValueCollection(IEqualityComparer) instead.")]
public NameValueCollection (System.Collections.IHashCodeProvider? hashProvider, System.Collections.IComparer? comparer);
[System.Obsolete("Please use NameValueCollection(IEqualityComparer) instead.")]
public NameValueCollection (System.Collections.IHashCodeProvider hashProvider, System.Collections.IComparer comparer);
public NameValueCollection (System.Collections.IHashCodeProvider hashProvider, System.Collections.IComparer comparer);
[<System.Obsolete("Please use NameValueCollection(IEqualityComparer) instead.")>]
new System.Collections.Specialized.NameValueCollection : System.Collections.IHashCodeProvider * System.Collections.IComparer -> System.Collections.Specialized.NameValueCollection
[<System.Obsolete("This constructor has been deprecated. Use NameValueCollection(IEqualityComparer) instead.")>]
new System.Collections.Specialized.NameValueCollection : System.Collections.IHashCodeProvider * System.Collections.IComparer -> System.Collections.Specialized.NameValueCollection
new System.Collections.Specialized.NameValueCollection : System.Collections.IHashCodeProvider * System.Collections.IComparer -> System.Collections.Specialized.NameValueCollection
Public Sub New (hashProvider As IHashCodeProvider, comparer As IComparer)

参数

hashProvider
IHashCodeProvider

IHashCodeProvider 将为 NameValueCollection 中的所有键提供哈希代码。

comparer
IComparer

IComparer，用于确定两个键是否相等。

属性
ObsoleteAttribute

注解

的 NameValueCollection 容量是 可以容纳的元素 NameValueCollection 数。 当元素添加到 时 NameValueCollection，容量会根据需要通过重新分配内部数组自动增加。

如果可以估计集合的大小，则指定初始容量就无需在向 中添加元素 NameValueCollection时执行大量调整大小操作。

哈希代码提供程序为 中的 NameValueCollection键分配哈希代码。 默认哈希代码提供程序为 CaseInsensitiveHashCodeProvider。

比较器确定两个键是否相等。 默认比较器为 CaseInsensitiveComparer。

此构造函数是一个 O (1) 操作。

另请参阅

适用于

NameValueCollection(Int32, IEqualityComparer)

Source:
NameValueCollection.cs
Source:
NameValueCollection.cs
Source:
NameValueCollection.cs

初始化 NameValueCollection 类的新实例，该实例为空、具有指定的初始容量并使用指定的 IEqualityComparer 对象。

public:
 NameValueCollection(int capacity, System::Collections::IEqualityComparer ^ equalityComparer);
public NameValueCollection (int capacity, System.Collections.IEqualityComparer equalityComparer);
public NameValueCollection (int capacity, System.Collections.IEqualityComparer? equalityComparer);
new System.Collections.Specialized.NameValueCollection : int * System.Collections.IEqualityComparer -> System.Collections.Specialized.NameValueCollection
Public Sub New (capacity As Integer, equalityComparer As IEqualityComparer)

参数

capacity
Int32

NameValueCollection 对象可包含的初始项数。

equalityComparer
IEqualityComparer

IEqualityComparer 对象，用于确定两个键是否相等，并为集合中的键生成哈希代码。

例外

ArgumentOutOfRangeException

capacity 小于零。

注解

对象的容量 NameValueCollection 是 可以容纳的元素 NameValueCollection 数。 当元素添加到 时 NameValueCollection，容量会根据需要通过重新分配内部数组自动增加。

如果可以估计集合的大小，则指定初始容量就无需在向 中添加元素 NameValueCollection时执行大量调整大小操作。

对象 IEqualityComparer 将比较器和哈希代码提供程序组合在一起。 哈希代码提供程序为 中的 NameValueCollection键分配哈希代码。 比较器确定两个键是否相等。

此构造函数是 O (n) 操作，其中 n 是 capacity 参数。

另请参阅

适用于

NameValueCollection(Int32, NameValueCollection)

Source:
NameValueCollection.cs
Source:
NameValueCollection.cs
Source:
NameValueCollection.cs

将项从指定的 NameValueCollection 复制到一个新的 NameValueCollection，这个新集合使用指定的初始容量或与具有与复制的项数相等的初始容量（两者中较大的一个），并使用不区分大小写的默认哈希代码提供程序和不区分大小写的默认比较器。

public:
 NameValueCollection(int capacity, System::Collections::Specialized::NameValueCollection ^ col);
public NameValueCollection (int capacity, System.Collections.Specialized.NameValueCollection col);
new System.Collections.Specialized.NameValueCollection : int * System.Collections.Specialized.NameValueCollection -> System.Collections.Specialized.NameValueCollection
Public Sub New (capacity As Integer, col As NameValueCollection)

参数

capacity
Int32

NameValueCollection 可包含的初始项数。

col
NameValueCollection

要复制到新 NameValueCollection 实例的 NameValueCollection。

例外

ArgumentOutOfRangeException

capacity 小于零。

ArgumentNullException

col 为 null。

注解

的 NameValueCollection 容量是 可以容纳的元素 NameValueCollection 数。 当元素添加到 时 NameValueCollection，容量会根据需要通过重新分配内部数组自动增加。

如果可以估计集合的大小，则指定初始容量就无需在向 中添加元素 NameValueCollection时执行大量调整大小操作。

哈希代码提供程序为 中的 NameValueCollection键分配哈希代码。 默认哈希代码提供程序为 CaseInsensitiveHashCodeProvider。

比较器确定两个键是否相等。 默认比较器为 CaseInsensitiveComparer。

此构造函数是 O (n) 操作，其中 n 为 capacity。 如果 中的col元素数大于 capacity，此构造函数将成为 O (nm + ) 操作，其中 n 是 capacity 和 m 中的col元素数。

另请参阅

适用于

NameValueCollection(SerializationInfo, StreamingContext)

Source:
NameValueCollection.cs
Source:
NameValueCollection.cs
Source:
NameValueCollection.cs

注意

This API supports obsolete formatter-based serialization. It should not be called or extended by application code.

初始化 NameValueCollection 类的新实例，该实例可序列化且使用指定的 SerializationInfo 和 StreamingContext。

protected:
 NameValueCollection(System::Runtime::Serialization::SerializationInfo ^ info, System::Runtime::Serialization::StreamingContext context);
protected NameValueCollection (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);
[System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
protected NameValueCollection (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);
new System.Collections.Specialized.NameValueCollection : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> System.Collections.Specialized.NameValueCollection
[<System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
new System.Collections.Specialized.NameValueCollection : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> System.Collections.Specialized.NameValueCollection
Protected Sub New (info As SerializationInfo, context As StreamingContext)

参数

info
SerializationInfo

SerializationInfo 对象，包含序列化新 NameValueCollection 实例所需的信息。

context
StreamingContext

StreamingContext 对象，包含与新 NameValueCollection 实例关联的序列化流的源和目标。

属性
ObsoleteAttribute

注解

此构造函数是一个 O (1) 操作。

另请参阅

适用于

NameValueCollection(Int32, IHashCodeProvider, IComparer)

Source:
NameValueCollection.cs
Source:
NameValueCollection.cs
Source:
NameValueCollection.cs

注意

Please use NameValueCollection(Int32, IEqualityComparer) instead.

注意

This constructor has been deprecated. Use NameValueCollection(Int32, IEqualityComparer) instead.

初始化 NameValueCollection 类的新实例，该实例为空且具有指定的初始容量，并使用指定的哈希代码提供程序和指定的比较器。

public:
 NameValueCollection(int capacity, System::Collections::IHashCodeProvider ^ hashProvider, System::Collections::IComparer ^ comparer);
[System.Obsolete("Please use NameValueCollection(Int32, IEqualityComparer) instead.")]
public NameValueCollection (int capacity, System.Collections.IHashCodeProvider? hashProvider, System.Collections.IComparer? comparer);
[System.Obsolete("This constructor has been deprecated. Use NameValueCollection(Int32, IEqualityComparer) instead.")]
public NameValueCollection (int capacity, System.Collections.IHashCodeProvider? hashProvider, System.Collections.IComparer? comparer);
[System.Obsolete("Please use NameValueCollection(Int32, IEqualityComparer) instead.")]
public NameValueCollection (int capacity, System.Collections.IHashCodeProvider hashProvider, System.Collections.IComparer comparer);
public NameValueCollection (int capacity, System.Collections.IHashCodeProvider hashProvider, System.Collections.IComparer comparer);
[<System.Obsolete("Please use NameValueCollection(Int32, IEqualityComparer) instead.")>]
new System.Collections.Specialized.NameValueCollection : int * System.Collections.IHashCodeProvider * System.Collections.IComparer -> System.Collections.Specialized.NameValueCollection
[<System.Obsolete("This constructor has been deprecated. Use NameValueCollection(Int32, IEqualityComparer) instead.")>]
new System.Collections.Specialized.NameValueCollection : int * System.Collections.IHashCodeProvider * System.Collections.IComparer -> System.Collections.Specialized.NameValueCollection
new System.Collections.Specialized.NameValueCollection : int * System.Collections.IHashCodeProvider * System.Collections.IComparer -> System.Collections.Specialized.NameValueCollection
Public Sub New (capacity As Integer, hashProvider As IHashCodeProvider, comparer As IComparer)

参数

capacity
Int32

NameValueCollection 可包含的初始项数。

hashProvider
IHashCodeProvider

IHashCodeProvider 将为 NameValueCollection 中的所有键提供哈希代码。

comparer
IComparer

IComparer，用于确定两个键是否相等。

属性
ObsoleteAttribute

例外

ArgumentOutOfRangeException

capacity 小于零。

注解

的 NameValueCollection 容量是 可以容纳的元素 NameValueCollection 数。 当元素添加到 时 NameValueCollection，容量会根据需要通过重新分配内部数组自动增加。

如果可以估计集合的大小，则指定初始容量就无需在向 中添加元素 NameValueCollection时执行大量调整大小操作。

哈希代码提供程序为 中的 NameValueCollection键分配哈希代码。 默认哈希代码提供程序为 CaseInsensitiveHashCodeProvider。

比较器确定两个键是否相等。 默认比较器为 CaseInsensitiveComparer。

此构造函数是 O (n) 操作，其中 n 为 capacity。

另请参阅

适用于