NameValueCollection.Add Method

Definition

Namespace:

System.Collections.Specialized

Assembly:

System.Collections.Specialized.dll

Adds entries to the current NameValueCollection.

Overloads

Add(NameValueCollection)	Copies the entries in the specified NameValueCollection to the current NameValueCollection.
Add(String, String)	Adds an entry with the specified name and value to the NameValueCollection.

Add(NameValueCollection)

Source:

NameValueCollection.cs

Copies the entries in the specified NameValueCollection to the current 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)

Parameters

c

NameValueCollection

The NameValueCollection to copy to the current NameValueCollection.

Exceptions

NotSupportedException

The collection is read-only.

ArgumentNullException

c is null.

Remarks

If a key in c already exists in the target NameValueCollection instance, the associated value in c is added to the existing comma-separated list of values associated with the same key in the target NameValueCollection instance.

If Count already equals the capacity, the capacity of the NameValueCollection is increased by automatically reallocating the internal array, and the existing elements are copied to the new array before the new element is added.

If Count is less than the capacity, this method is an O(1) operation. If the capacity needs to be increased to accommodate the new element, this method becomes an O(n) operation, where n is Count.

See also

• Set(String, String)

Add(String, String)

Source:

NameValueCollection.cs

Adds an entry with the specified name and value to the 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)

Parameters

name

String

The String key of the entry to add. The key can be null.

value

String

The String value of the entry to add. The value can be null.

Exceptions

NotSupportedException

The collection is read-only.

Remarks

If the specified key already exists in the target NameValueCollection instance, the specified value is added to the existing comma-separated list of values in the form "value1,value2,value3". The values are associated with the same key in the target NameValueCollection instance.

If Count already equals the capacity, the capacity of the NameValueCollection is increased by automatically reallocating the internal array, and the existing elements are copied to the new array before the new element is added.

If Count is less than the capacity, this method is an O(1) operation. If the capacity needs to be increased to accommodate the new element, this method becomes an O(n) operation, where n is Count.