System.Net.WebHeaderCollection.Add Method

Inserts the specified header into the collection.

Syntax

public void Add (string header)

Parameters

header
The header to add, with the name and value separated by a colon.

Exceptions

TypeReason
ArgumentNullException header is null or string.Empty.
ArgumentException

header does not contain a colon (:) character.

-or-

name is string.Empty, or contains invalid characters.

-or-

header is a protected header that can only be set with a property accessor or by the system.

-or-

value contains invalid characters.

Remarks

The header parameter must be specified in the format "name:value". If the specified header does not exist in the collection, a new header is added to the collection.

If the header specified in header is already present in the collection, the value part of the header is concatenated with the existing value.

Requirements

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