HttpListenerResponse.AddHeader(String, String) Método

Definição

Namespace:

System.Net

Assembly:

System.Net.HttpListener.dll

Origem:

HttpListenerResponse.cs

Adiciona o cabeçalho e o valor especificados aos cabeçalhos HTTP dessa resposta.

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)

Parâmetros

name

String

O nome do cabeçalho HTTP a ser definido.

value

String

O valor do cabeçalho name.

Exceções

ArgumentNullException

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

ArgumentException

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.

Exemplos

O exemplo de código a seguir demonstra como adicionar um cabeçalho usando essa propriedade.

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

Comentários

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

Se o cabeçalho especificado em name não existir, esse método inserirá um novo cabeçalho na Headers coleção da propriedade. Se name estiver presente na coleção, esse método substituirá o valor existente por value. Para adicionar um valor a um cabeçalho existente sem substituir o valor existente, use o AppendHeader método .

Confira também

• HttpListener
• HttpListenerContext
• HttpListenerRequest
• WebHeaderCollection