Partilhar via


HttpListenerResponse.AddHeader(String, String) Método

Definição

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

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

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

- ou -

name ou value contém caracteres inválidos.

.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 .

Aplica-se a

Confira também