NameValueCollection.Add 方法

定义

命名空间:

System.Collections.Specialized

程序集:

System.Collections.Specialized.dll

将项添加到当前 NameValueCollection。

重载

Add(NameValueCollection)	将指定 NameValueCollection 中的项复制到当前 NameValueCollection。
Add(String, String)	将具有指定名称和值的项添加到 NameValueCollection。

Add(NameValueCollection)

Source:

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)

Source:

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。