HttpListenerResponse.Headers Proprietà

Definizione

Ottiene o imposta un insieme di coppie nome/valore di intestazione restituite dal server.Gets or sets the collection of header name/value pairs returned by the server.

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

Valore della proprietà

Istanza di WebHeaderCollection contenente tutte le intestazioni HTTP impostate in modo esplicito da includere nella risposta.A WebHeaderCollection instance that contains all the explicitly set HTTP headers to be included in the response.

Eccezioni

L'istanza di WebHeaderCollection specificata per un'operazione di impostazione non è valida per una risposta.The WebHeaderCollection instance specified for a set operation is not valid for a response.

Esempi

Nell'esempio di codice riportato di seguito viene illustrata la visualizzazione delle intestazioni in un WebHeaderCollection.The following code example demonstrates displaying the headers in a 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

Commenti

Le intestazioni di risposta contengono informazioni sui metadati, ad esempio la data e l'ora della risposta, l'identità del server di risposta e il tipo MIME dei dati contenuti nel corpo della risposta.Response headers contain metadata information such as the date and time of the response, the identity of the responding server, and the MIME type of the data contained in the response body.

Per un elenco completo delle intestazioni di risposta, vedere l'enumerazione HttpResponseHeader.For a complete list of response headers, see the HttpResponseHeader enumeration.

Nota

Se si tenta di impostare un'intestazione Content-Length, Keep-Alive, Transfer-Encoding o WWW-Authenticate usando la proprietà Headers, verrà generata un'eccezione.If you attempt to set a Content-Length, Keep-Alive, Transfer-Encoding, or WWW-Authenticate header using the Headers property, an exception will be thrown. Per impostare queste intestazioni, utilizzare le proprietà KeepAlive o ContentLength64.Use the KeepAlive or ContentLength64 properties to set these headers. Non è possibile impostare manualmente le intestazioni Transfer-Encoding o WWW-Authenticate.You cannot set the Transfer-Encoding or WWW-Authenticate headers manually.

Si applica a

Vedi anche