NameValueCollection 建構函式

定義

命名空間:

System.Collections.Specialized

組件:

System.Collections.Specialized.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()

來源:

NameValueCollection.cs

初始化 NameValueCollection 類別的新執行個體，這個執行個體是空白的、具有預設的初始容量，並使用預設不區分大小寫的雜湊碼提供者和預設不區分大小寫的比較子。

public:
 NameValueCollection();

public NameValueCollection ();

Public Sub New ()

備註

的 NameValueCollection 容量是 可以保留的項目 NameValueCollection 數目。 當元素新增至 NameValueCollection時，重新配置內部數位會自動增加容量。

如果可以估計集合的大小，則指定初始容量就不需要在將元素加入 至 NameValueCollection時執行一些重設大小作業。

哈希碼提供者會為 中的 NameValueCollection索引鍵分配哈希碼。 預設哈希碼提供者為 CaseInsensitiveHashCodeProvider。

比較子會判斷兩個索引鍵是否相等。 預設比較子是 CaseInsensitiveComparer。

此建構函式是 O (1) 作業。

另請參閱

• CaseInsensitiveHashCodeProvider
• CaseInsensitiveComparer
• 執行不區分文化特性的字串作業

NameValueCollection(IEqualityComparer)

來源:

NameValueCollection.cs

初始化 NameValueCollection 類別的新執行個體，這個執行個體是空白的、具有預設的初始容量，並使用指定的 IEqualityComparer 物件。

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) 作業。

另請參閱

• IEqualityComparer
• 執行不區分文化特性的字串作業

NameValueCollection(NameValueCollection)

來源:

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項目數目。

另請參閱

• CaseInsensitiveHashCodeProvider
• CaseInsensitiveComparer
• 執行不區分文化特性的字串作業

NameValueCollection(Int32)

來源:

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。

另請參閱

• CaseInsensitiveHashCodeProvider
• CaseInsensitiveComparer
• 執行不區分文化特性的字串作業

NameValueCollection(IHashCodeProvider, IComparer)

來源:

NameValueCollection.cs

警告

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

初始化 NameValueCollection 類別的新執行個體，這個執行個體是空白的、具有預設的初始容量，並使用指定的雜湊碼提供者和指定的比較子。

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("This constructor has been deprecated. Use NameValueCollection(IEqualityComparer) instead.")>]
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) 作業。

另請參閱

• IHashCodeProvider
• CaseInsensitiveHashCodeProvider
• IComparer
• CaseInsensitiveComparer
• 執行不區分文化特性的字串作業

NameValueCollection(Int32, IEqualityComparer)

來源:

NameValueCollection.cs

初始化 NameValueCollection 類別的新執行個體，這個執行個體是空白的、具有指定的初始容量，並使用指定的 IEqualityComparer 物件。

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 參數。

另請參閱

• IEqualityComparer
• 執行不區分文化特性的字串作業

NameValueCollection(Int32, NameValueCollection)

來源:

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 (mn + ) 作業，其中 是 capacity ，m而 n 是中的col項目數目。

另請參閱

• CaseInsensitiveHashCodeProvider
• CaseInsensitiveComparer
• 執行不區分文化特性的字串作業

NameValueCollection(SerializationInfo, StreamingContext)

來源:

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);

[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);

[<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) 作業。

另請參閱

• ISerializable
• SerializationInfo
• StreamingContext
• 執行不區分文化特性的字串作業

NameValueCollection(Int32, IHashCodeProvider, IComparer)

來源:

NameValueCollection.cs

警告

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("This constructor has been deprecated. 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.")>]
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。

另請參閱

• CaseInsensitiveHashCodeProvider
• CaseInsensitiveComparer
• 執行不區分文化特性的字串作業