NameValueCollection 建構函式

定義

命名空間:: System.Collections.Specialized

組件:: System.dll, System.Collections.Specialized.dll

組件:: netstandard.dll, System.Collections.Specialized.dll

組件:: System.Collections.Specialized.dll

組件:: System.dll

組件:: netstandard.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

初始化 NameValueCollection 類別的新執行個體。

多載

名稱	Description
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.cs

來源:: NameValueCollection.cs

來源:: NameValueCollection.cs

來源:: NameValueCollection.cs

初始化一個新的類別實例，該實例 NameValueCollection 為空，初始容量為預設，並使用預設大小寫不區分的雜湊碼提供者及預設大小寫不區分比較器。

public:
 NameValueCollection();

public NameValueCollection();

Public Sub New ()

備註

a NameValueCollection 的容量是它 NameValueCollection 能容納的元素數量。當元素加入 NameValueCollection時，容量會自動透過重新配置內部陣列而增加。

若能估計集合的大小，指定初始容量即可免除在加入元素 NameValueCollection時進行多次調整大小操作的需求。

雜湊碼提供者會為 NameValueCollection. 預設的雜湊碼提供者為 CaseInsensitiveHashCodeProvider.

比較器判斷兩個鍵是否相等。預設比較器為 CaseInsensitiveComparer。

此構造子為 O（1）運算。

另請參閱

適用於

NameValueCollection(IEqualityComparer)

來源:: NameValueCollection.cs

來源:: NameValueCollection.cs

來源:: NameValueCollection.cs

來源:: NameValueCollection.cs

來源:: 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)

來源:: NameValueCollection.cs

來源:: NameValueCollection.cs

來源:: NameValueCollection.cs

來源:: NameValueCollection.cs

來源:: 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。

備註

a NameValueCollection 的容量是它 NameValueCollection 能容納的元素數量。當元素加入 NameValueCollection時，容量會自動透過重新配置內部陣列而增加。

若能估計集合的大小，指定初始容量即可免除在加入元素 NameValueCollection時進行多次調整大小操作的需求。

雜湊碼提供者會為 NameValueCollection. 預設的雜湊碼提供者為 CaseInsensitiveHashCodeProvider.

比較器判斷兩個鍵是否相等。預設比較器為 CaseInsensitiveComparer。

新 NameValueCollection 元素的排序順序與來源 NameValueCollection相同。

此構造子為 O（n）運算，其中 n 為中的 col元素數量。

另請參閱

適用於

NameValueCollection(Int32)

來源:: NameValueCollection.cs

來源:: NameValueCollection.cs

來源:: NameValueCollection.cs

來源:: NameValueCollection.cs

來源:: 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 小於零。

備註

a NameValueCollection 的容量是它 NameValueCollection 能容納的元素數量。當元素加入 NameValueCollection時，容量會自動透過重新配置內部陣列而增加。

若能估計集合的大小，指定初始容量即可免除在加入元素 NameValueCollection時進行多次調整大小操作的需求。

雜湊碼提供者會為 NameValueCollection. 預設的雜湊碼提供者為 CaseInsensitiveHashCodeProvider.

比較器判斷兩個鍵是否相等。預設比較器為 CaseInsensitiveComparer。

此構造子是一個 O（n）運算，其中 n 為 capacity。

另請參閱

適用於

NameValueCollection(IHashCodeProvider, IComparer)

來源:: NameValueCollection.cs

來源:: NameValueCollection.cs

來源:: NameValueCollection.cs

來源:: NameValueCollection.cs

來源:: NameValueCollection.cs

警告

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

警告

Please 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("Please 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("This constructor has been deprecated. Use NameValueCollection(IEqualityComparer) instead.")>]
new System.Collections.Specialized.NameValueCollection : System.Collections.IHashCodeProvider * System.Collections.IComparer -> System.Collections.Specialized.NameValueCollection

[<System.Obsolete("Please 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

備註

a NameValueCollection 的容量是它 NameValueCollection 能容納的元素數量。當元素加入 NameValueCollection時，容量會自動透過重新配置內部陣列而增加。

若能估計集合的大小，指定初始容量即可免除在加入元素 NameValueCollection時進行多次調整大小操作的需求。

雜湊碼提供者會為 NameValueCollection. 預設的雜湊碼提供者為 CaseInsensitiveHashCodeProvider.

比較器判斷兩個鍵是否相等。預設比較器為 CaseInsensitiveComparer。

此構造子為 O（1）運算。

另請參閱

適用於

NameValueCollection(Int32, IEqualityComparer)

來源:: NameValueCollection.cs

來源:: NameValueCollection.cs

來源:: NameValueCollection.cs

來源:: NameValueCollection.cs

來源:: 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)

來源:: NameValueCollection.cs

來源:: NameValueCollection.cs

來源:: NameValueCollection.cs

來源:: NameValueCollection.cs

來源:: 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。

備註

a NameValueCollection 的容量是它 NameValueCollection 能容納的元素數量。當元素加入 NameValueCollection時，容量會自動透過重新配置內部陣列而增加。

若能估計集合的大小，指定初始容量即可免除在加入元素 NameValueCollection時進行多次調整大小操作的需求。

雜湊碼提供者會為 NameValueCollection. 預設的雜湊碼提供者為 CaseInsensitiveHashCodeProvider.

比較器判斷兩個鍵是否相等。預設比較器為 CaseInsensitiveComparer。

此構造子是一個 O（n）運算，其中 n 為 capacity。若中的col元素數大於 capacity，則該構造子成為 O（n + m）運算，其中 n 是 capacitym ，是中的col元素數。

另請參閱

適用於

NameValueCollection(SerializationInfo, StreamingContext)

來源:: NameValueCollection.cs

來源:: NameValueCollection.cs

來源:: NameValueCollection.cs

來源:: NameValueCollection.cs

來源:: 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);

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

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)

來源:: NameValueCollection.cs

來源:: NameValueCollection.cs

來源:: NameValueCollection.cs

來源:: NameValueCollection.cs

來源:: NameValueCollection.cs

警告

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

警告

Please 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("Please 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("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

[<System.Obsolete("Please 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 小於零。

備註

a NameValueCollection 的容量是它 NameValueCollection 能容納的元素數量。當元素加入 NameValueCollection時，容量會自動透過重新配置內部陣列而增加。

若能估計集合的大小，指定初始容量即可免除在加入元素 NameValueCollection時進行多次調整大小操作的需求。

雜湊碼提供者會為 NameValueCollection. 預設的雜湊碼提供者為 CaseInsensitiveHashCodeProvider.

比較器判斷兩個鍵是否相等。預設比較器為 CaseInsensitiveComparer。

此構造子是一個 O（n）運算，其中 n 為 capacity。

另請參閱

適用於

意見反應

此頁面對您有幫助嗎？