HttpListenerRequest.Headers Propriedade

Definição

Namespace:

System.Net

Assembly:

System.Net.HttpListener.dll

Origem:

HttpListenerRequest.Managed.cs

Obtém a coleção de pares de nome/valor do cabeçalho enviado na solicitação.

public:
 property System::Collections::Specialized::NameValueCollection ^ Headers { System::Collections::Specialized::NameValueCollection ^ get(); };

public System.Collections.Specialized.NameValueCollection Headers { get; }

member this.Headers : System.Collections.Specialized.NameValueCollection

Public ReadOnly Property Headers As NameValueCollection

Valor da propriedade

NameValueCollection

Um WebHeaderCollection que contém os cabeçalhos HTTP incluídos na solicitação.

Exemplos

O exemplo de código a seguir exibe todas as informações em um determinado WebHeaderCollection objeto.

    // Displays the header information that accompanied a request.
public static void DisplayWebHeaderCollection(HttpListenerRequest request)
{
    System.Collections.Specialized.NameValueCollection headers = request.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.");
        }
    }
}

Public Shared Sub DisplayWebHeaderCollection(ByVal request As HttpListenerRequest)
    Dim headers As System.Collections.Specialized.NameValueCollection = request.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 solicitação contêm informações de metadados. Por exemplo, os cabeçalhos podem conter o URI (Uniform Resource Identifier) do recurso que encaminhou o cliente para o servidor, a identidade do agente de usuário empregado pelo cliente e os tipos MIME aceitáveis para dados no corpo da resposta.

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

Confira também

• HttpListener
• HttpListenerContext
• HttpListenerResponse