HttpListenerResponse::AddHeader Method (String^, String^)
Adds the specified header and value to the HTTP headers for this response.
Assembly: System (in System.dll)
Parameters
- name
-
Type:
System::String^
The name of the HTTP header to set.
- value
-
Type:
System::String^
The value for the name header.
| Exception | Condition |
|---|---|
| ArgumentNullException | name is null or an empty string (""). |
| ArgumentException | You are not allowed to specify a value for the specified header. -or- name or value contains invalid characters. |
| ArgumentOutOfRangeException | The length of value is greater than 65,535 characters. |
Calling this method is equivalent to calling the Set method on the collection returned by the Headers property.
If the header specified in name does not exist, this method inserts a new header into the Headers property's collection. If name is present in the collection, this method replaces the existing value with value. To add a value to an existing header without replacing the existing value, use the AppendHeader method.
The following code example demonstrates adding a header using this property.
public static void SetExpirationDate(long seconds, HttpListenerResponse response) { response.AddHeader("Expires", seconds.ToString()); }
Available since 2.0