NameValueCollection.Add 方法

定義

命名空間:

System.Collections.Specialized

組件:

System.Collections.Specialized.dll

將項目加入目前的 NameValueCollection。

多載

Add(NameValueCollection)	將指定 NameValueCollection 中的項目複製到目前的 NameValueCollection。
Add(String, String)	將具有指定名稱和數值的項目加入 NameValueCollection。

Add(NameValueCollection)

來源:

NameValueCollection.cs

將指定 NameValueCollection 中的項目複製到目前的 NameValueCollection。

public:
 void Add(System::Collections::Specialized::NameValueCollection ^ c);

public void Add (System.Collections.Specialized.NameValueCollection c);

member this.Add : System.Collections.Specialized.NameValueCollection -> unit

Public Sub Add (c As NameValueCollection)

參數

c

NameValueCollection

要複製到目前 NameValueCollection 的 NameValueCollection。

例外狀況

NotSupportedException

集合是唯讀的。

ArgumentNullException

c 為 null。

備註

如果 中的 c 索引鍵已存在於目標 NameValueCollection 實例中，則 中的 c 關聯值會新增至與目標 NameValueCollection 實例中相同索引鍵相關聯的現有逗號分隔值清單。

如果 Count 已經等於容量，則會藉由自動重新配置內部數位來增加的容量 NameValueCollection ，並在新增專案之前，將現有的元素複製到新的陣列。

如果 Count 小於容量，這個方法是 O (1) 作業。 如果需要增加容量以容納新元素，這個方法會變成 O (n) 作業，其中 n 是 Count。

另請參閱

• Set(String, String)

Add(String, String)

來源:

NameValueCollection.cs

將具有指定名稱和數值的項目加入 NameValueCollection。

public:
 virtual void Add(System::String ^ name, System::String ^ value);

public virtual void Add (string? name, string? value);

abstract member Add : string * string -> unit
override this.Add : string * string -> unit

Public Overridable Sub Add (name As String, value As String)

參數

name

String

要加入之項目的 String 索引鍵。 這個索引鍵可以是 null。

value

String

要加入之項目的 String 值。 這個值可以是 null。

例外狀況

NotSupportedException

集合是唯讀的。

備註

如果目標 NameValueCollection 實例中已經有指定的索引鍵，則指定的值會新增至格式 "value1,value2,value3"中現有的逗號分隔值清單。 這些值與目標 NameValueCollection 實例中的相同索引鍵相關聯。

如果 Count 已經等於容量，則會藉由自動重新配置內部數位來增加的容量 NameValueCollection ，並在新增專案之前，將現有的元素複製到新的陣列。

如果 Count 小於容量，這個方法是 O (1) 作業。 如果需要增加容量以容納新元素，這個方法會變成 O (n) 作業，其中 n 是 Count。