HttpListenerResponse.AppendHeader(String, String) Método

Definição

Namespace:

System.Net

Assembly:

System.Net.HttpListener.dll

Origem:

HttpListenerResponse.cs

Acrescenta um valor ao cabeçalho HTTP especificado a ser enviado com essa resposta.

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

public void AppendHeader (string name, string value);

member this.AppendHeader : string * string -> unit

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

Parâmetros

name

String

O nome do cabeçalho HTTP ao qual acrescentar value.

value

String

O valor para acrescentar ao cabeçalho name.

Exceções

ArgumentException

name é null ou uma cadeia de caracteres vazia ("").

- ou -

Você não tem permissão para especificar um valor para o cabeçalho especificado.

- ou -

name ou value contém caracteres inválidos.

ArgumentOutOfRangeException

.NET Framework e NET Core versões 2.0 - 3.1 apenas: o comprimento de value é maior que 65.535 caracteres.

Comentários

Chamar esse método é equivalente a chamar o Add método na coleção retornada pela Headers propriedade .

Se o cabeçalho especificado em header não existir, esse método inserirá um novo cabeçalho na Headers coleção da propriedade. Se header estiver presente na coleção, esse método adicionará value aos valores existentes. Para substituir o valor de um cabeçalho existente, use o AddHeader método .

Confira também

• HttpListener
• HttpListenerContext
• HttpListenerRequest