Поделиться через


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

Определение

Добавляет указанный заголовок и значение в заголовок 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.

Исключения

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

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

-или-

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

Только .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 значения, используйте метод .

Применяется к

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