HttpListenerResponse.AddHeader(String, String) Метод

Определение

Пространство имен:

System.Net

Сборка:

System.Net.HttpListener.dll

Исходный код:

HttpListenerResponse.cs

Добавляет указанный заголовок и значение в заголовок HTTP для этого ответа.

public:
 void AddHeader(System::String ^ name, System::String ^ value);

public void AddHeader (string name, string value);

member this.AddHeader : string * string -> unit

Public Sub AddHeader (name As String, value As String)

Параметры

name

String

Имя устанавливаемого HTTP-заголовка.

value

String

Значение заголовка name.

Исключения

ArgumentNullException

Параметр name имеет значение null или равен пустой строке ("").

ArgumentException

Пользователь не может указывать значение для указанного заголовка.

-или-

name или value содержат недопустимые символы.

ArgumentOutOfRangeException

Только .NET Framework и .NET Core версий 2.0–3.1: длина value превышает 65 535 символов.

Примеры

В следующем примере кода показано добавление заголовка с помощью этого свойства.

public static void SetExpirationDate(long seconds, HttpListenerResponse response)
{
    response.AddHeader("Expires", seconds.ToString());
}

Public Shared Sub SetExpirationDate(ByVal seconds As Long, ByVal response As HttpListenerResponse)
    response.AddHeader("Expires", seconds.ToString())
End Sub

Комментарии

Вызов этого метода эквивалентен вызову Set метода в коллекции, возвращаемой свойством Headers .

Если заголовок, указанный в , name не существует, этот метод вставляет новый заголовок в коллекцию Headers свойства. Если name он присутствует в коллекции, этот метод заменяет существующее значение на value. Чтобы добавить значение в существующий заголовок без замены существующего значения, используйте AppendHeader метод .

См. также раздел

• HttpListener
• HttpListenerContext
• HttpListenerRequest
• WebHeaderCollection