HttpListenerResponse.Headers Propriété

Définition

Espace de noms:

System.Net

Assembly:

System.Net.HttpListener.dll

Source:

HttpListenerResponse.cs

Obtient ou définit la collection de paires nom/valeur d'en-tête retournées par le serveur.

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

Valeur de propriété

WebHeaderCollection

Instance de WebHeaderCollection qui contient tous les en-têtes HTTP explicitement définis à inclure dans la réponse.

Exceptions

InvalidOperationException

L'instance de WebHeaderCollection spécifiée pour une opération set n'est pas valide pour une réponse.

Exemples

L’exemple de code suivant illustre l’affichage des en-têtes dans un 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

Remarques

Les en-têtes de réponse contiennent des informations de métadonnées telles que la date et l’heure de la réponse, l’identité du serveur qui répond et le type MIME des données contenues dans le corps de la réponse.

Pour obtenir la liste complète des en-têtes de réponse, consultez l’énumération HttpResponseHeader .

Notes

Si vous tentez de définir un en-tête Content-Length, Keep-Alive, Transfer-Encoding ou WWW-Authenticate à l’aide de la propriété Headers, une exception est levée. Utilisez les KeepAlive propriétés ou ContentLength64 pour définir ces en-têtes. Vous ne pouvez pas définir manuellement les en-têtes Transfer-Encoding ou WWW-Authenticate.

Voir aussi

• HttpListener
• HttpListenerContext
• HttpListenerRequest