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