HttpListenerResponse.Headers Propriedade

Definição

Namespace:

System.Net

Assembly:

System.Net.HttpListener.dll

Origem:

HttpListenerResponse.cs

Obtém ou define uma coleção de pares de nome/valor de cabeçalho retornados pelo servidor.

public:
 property System::Net::WebHeaderCollection ^ Headers { System::Net::WebHeaderCollection ^ get(); void set(System::Net::WebHeaderCollection ^ value); };

public System.Net.WebHeaderCollection Headers { get; set; }

member this.Headers : System.Net.WebHeaderCollection with get, set

Public Property Headers As WebHeaderCollection

Valor da propriedade

WebHeaderCollection

Uma instância de WebHeaderCollection que contém todos os cabeçalhos HTTP explicitamente definidos a serem incluídos na resposta.

Exceções

InvalidOperationException

A instância de WebHeaderCollection especificada para uma operação de conjuntos não é válida para uma resposta.

Exemplos

O exemplo de código a seguir demonstra a exibição dos cabeçalhos em um WebHeaderCollection.

    // Displays the header information that accompanied a request.
public static void DisplayWebHeaderCollection(HttpListenerResponse response)
{
    WebHeaderCollection headers = response.Headers;
    // Get each header and display each value.
    foreach (string key in headers.AllKeys)
    {
        string[] values = headers.GetValues(key);
        if(values.Length > 0)
        {
            Console.WriteLine("The values of the {0} header are: ", key);
            foreach (string value in values)
            {
                Console.WriteLine("   {0}", value);
            }
        }
        else
        {
            Console.WriteLine("There is no value associated with the header.");
        }
    }
}

' Displays the header information that accompanied a request.
Public Shared Sub DisplayWebHeaderCollection(ByVal response As HttpListenerResponse)
    Dim headers As WebHeaderCollection = response.Headers

    ' Get each header and display each value.
    For Each key As String In headers.AllKeys
        Dim values As String() = headers.GetValues(key)

        If values.Length > 0 Then
            Console.WriteLine("The values of the {0} header are: ", key)

            For Each value As String In values
                Console.WriteLine("   {0}", value)
            Next
        Else
            Console.WriteLine("There is no value associated with the header.")
        End If
    Next
End Sub

Comentários

Os cabeçalhos de resposta contêm informações de metadados, como a data e a hora da resposta, a identidade do servidor que responde e o tipo MIME dos dados contidos no corpo da resposta.

Para obter uma lista completa de cabeçalhos de resposta, consulte a HttpResponseHeader enumeração .

Observação

Se você tentar definir um cabeçalho Content-Length, Keep-Alive, Transfer-Encoding ou WWW-Authenticate usando a propriedade Headers, uma exceção será gerada. Use as KeepAlive propriedades ou ContentLength64 para definir esses cabeçalhos. Não é possível definir os cabeçalhos Transfer-Encoding ou WWW-Authenticate manualmente.

Confira também

• HttpListener
• HttpListenerContext
• HttpListenerRequest