System.Collections.Specialized.NameValueCollection.Add Method

Adds an entry with the specified name and value to the System.Collections.Specialized.NameValueCollection.

Syntax

public virtual void Add (string name, string value)

Parameters

name
The string key of the entry to add. The key can be null.
value
The string value of the entry to add. The value can be null.

Exceptions

TypeReason
NotSupportedExceptionThe current instance is read-only.

Remarks

If the specified key already exists in the target System.Collections.Specialized.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 System.Collections.Specialized.NameValueCollection instance.

If NameObjectCollectionBase.Count already equals the capacity, the capacity of the System.Collections.Specialized.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 NameObjectCollectionBase.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 NameObjectCollectionBase.Count.

Requirements

Namespace: System.Collections.Specialized
Assembly: System (in System.dll)
Assembly Versions: 1.0.5000.0, 2.0.0.0, 4.0.0.0