NameValueCollection.Add Method

Definition

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)

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

Exceptions

The collection is read-only.

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

Applies to

Add(String, String)

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

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.

Applies to