HttpListenerRequest HttpListenerRequest HttpListenerRequest HttpListenerRequest Class

Definizione

Descrive una richiesta HTTP in arrivo a un oggetto HttpListener.Describes an incoming HTTP request to an HttpListener object. Questa classe non può essere ereditata.This class cannot be inherited.

public ref class HttpListenerRequest sealed
public sealed class HttpListenerRequest
type HttpListenerRequest = class
Public NotInheritable Class HttpListenerRequest
Ereditarietà
HttpListenerRequestHttpListenerRequestHttpListenerRequestHttpListenerRequest

Esempi

Nell'esempio di codice riportato di seguito viene illustrato come ricevere e HttpListenerRequestrispondere a.The following code example demonstrates how to receive and respond to a HttpListenerRequest.

// This example requires the System and System.Net namespaces.
public static void SimpleListenerExample(string[] prefixes)
{
    if (!HttpListener.IsSupported)
    {
        Console.WriteLine ("Windows XP SP2 or Server 2003 is required to use the HttpListener class.");
        return;
    }
    // URI prefixes are required,
    // for example "http://contoso.com:8080/index/".
    if (prefixes == null || prefixes.Length == 0)
      throw new ArgumentException("prefixes");
    
    // Create a listener.
    HttpListener listener = new HttpListener();
    // Add the prefixes.
    foreach (string s in prefixes)
    {
        listener.Prefixes.Add(s);
    }
    listener.Start();
    Console.WriteLine("Listening...");
    // Note: The GetContext method blocks while waiting for a request. 
    HttpListenerContext context = listener.GetContext();
    HttpListenerRequest request = context.Request;
    // Obtain a response object.
    HttpListenerResponse response = context.Response;
    // Construct a response.
    string responseString = "<HTML><BODY> Hello world!</BODY></HTML>";
    byte[] buffer = System.Text.Encoding.UTF8.GetBytes(responseString);
    // Get a response stream and write the response to it.
    response.ContentLength64 = buffer.Length;
    System.IO.Stream output = response.OutputStream;
    output.Write(buffer,0,buffer.Length);
    // You must close the output stream.
    output.Close();
    listener.Stop();
}
Public Shared Sub SimpleListenerExample(prefixes As String())
    If Not HttpListener.IsSupported Then
        Console.WriteLine("Windows XP SP2 or Server 2003 is required to use the HttpListener class.")
        Return
    End If
    ' URI prefixes are required,
    ' for example "http://contoso.com:8080/index/".
    If prefixes Is Nothing Or prefixes.Length = 0 Then
        Throw New ArgumentException("prefixes")
    End If

    ' Create a listener
    Dim listener = New HttpListener()

    For Each s As String In prefixes
        listener.Prefixes.Add(s)
    Next
    listener.Start()
    Console.WriteLine("Listening...")
    ' Note: The GetContext method blocks while waiting for a request.
    Dim context As HttpListenerContext = listener.GetContext()
    Console.WriteLine("Listening...")
    ' Obtain a response object
    Dim request As HttpListenerRequest = context.Request
    ' Construct a response.
    Dim response As HttpListenerResponse = context.Response
    Dim responseString As String = "<HTML><BODY> Hello world!</BODY></HTML>"
    Dim buffer As Byte() = System.Text.Encoding.UTF8.GetBytes(responseString)
    ' Get a response stream and write the response to it.
    response.ContentLength64 = buffer.Length
    Dim output As System.IO.Stream = response.OutputStream
    output.Write(buffer, 0, buffer.Length)
    'You must close the output stream.
    output.Close()
    listener.Stop()
End Sub

Commenti

Quando un client effettua una richiesta a un Uniform Resource Identifier (URI) gestito da un HttpListener oggetto HttpListener , fornisce un HttpListenerContext oggetto che contiene informazioni sul mittente, la richiesta e la risposta inviata al client.When a client makes a request to a Uniform Resource Identifier (URI) handled by an HttpListener object, the HttpListener provides a HttpListenerContext object that contains information about the sender, the request, and the response that is sent to the client. La HttpListenerContext.Request proprietà restituisce l' HttpListenerRequest oggetto che descrive la richiesta.The HttpListenerContext.Request property returns the HttpListenerRequest object that describes the request.

L' HttpListenerRequest oggetto contiene informazioni sulla richiesta, ad esempio la stringa della HttpMethod richiesta, UserAgent la stringa e i dati del corpo della richiesta InputStream (vedere la proprietà).The HttpListenerRequest object contains information about the request, such as the request HttpMethod string, UserAgent string, and request body data (see the InputStream property).

Per rispondere alla richiesta, è necessario ottenere la risposta associata usando la Response proprietà.To reply to the request, you must get the associated response using the Response property.

Proprietà

AcceptTypes AcceptTypes AcceptTypes AcceptTypes

Ottiene i tipi MIME accettati dal client.Gets the MIME types accepted by the client.

ClientCertificateError ClientCertificateError ClientCertificateError ClientCertificateError

Ottiene un codice di errore che identifica un problema con la classe X509Certificate fornita dal client.Gets an error code that identifies a problem with the X509Certificate provided by the client.

ContentEncoding ContentEncoding ContentEncoding ContentEncoding

Ottiene la codifica del contenuto che può essere utilizzata con i dati inviati con la richiestaGets the content encoding that can be used with data sent with the request

ContentLength64 ContentLength64 ContentLength64 ContentLength64

Ottiene la lunghezza dei dati del corpo inclusi nella richiesta.Gets the length of the body data included in the request.

ContentType ContentType ContentType ContentType

Ottiene il tipo MIME dei dati del corpo inclusi nella richiesta.Gets the MIME type of the body data included in the request.

Cookies Cookies Cookies Cookies

Ottiene i cookie inviati con la richiesta.Gets the cookies sent with the request.

HasEntityBody HasEntityBody HasEntityBody HasEntityBody

Ottiene un valore Boolean che indica se alla richiesta sono associati i dati del corpo.Gets a Boolean value that indicates whether the request has associated body data.

Headers Headers Headers Headers

Ottiene un insieme delle coppie nome/valore di intestazione inviate nella risposta.Gets the collection of header name/value pairs sent in the request.

HttpMethod HttpMethod HttpMethod HttpMethod

Ottiene il metodo HTTP specificato dal client.Gets the HTTP method specified by the client.

InputStream InputStream InputStream InputStream

Ottiene un flusso contenente i dati del corpo inviati dal client.Gets a stream that contains the body data sent by the client.

IsAuthenticated IsAuthenticated IsAuthenticated IsAuthenticated

Ottiene un valore Boolean che indica se il client che invia la richiesta è autenticato.Gets a Boolean value that indicates whether the client sending this request is authenticated.

IsLocal IsLocal IsLocal IsLocal

Ottiene un valore Boolean che indica se la richiesta proviene dal computer locale.Gets a Boolean value that indicates whether the request is sent from the local computer.

IsSecureConnection IsSecureConnection IsSecureConnection IsSecureConnection

Ottiene un valore Boolean che indica se la connessione TCP utilizzata per inviare la richiesta utilizza il protocollo SSL (Secure Sockets Layer).Gets a Boolean value that indicates whether the TCP connection used to send the request is using the Secure Sockets Layer (SSL) protocol.

IsWebSocketRequest IsWebSocketRequest IsWebSocketRequest IsWebSocketRequest

Ottiene un valore Boolean che indica se la connessione TCP era una richiesta a WebSocket.Gets a Boolean value that indicates whether the TCP connection was a WebSocket request.

KeepAlive KeepAlive KeepAlive KeepAlive

Ottiene un valore Boolean che indica se dal client viene richiesta una connessione permanente.Gets a Boolean value that indicates whether the client requests a persistent connection.

LocalEndPoint LocalEndPoint LocalEndPoint LocalEndPoint

Ottiene l'indirizzo IP e il numero di porta del server a cui è diretta la richiesta.Gets the server IP address and port number to which the request is directed.

ProtocolVersion ProtocolVersion ProtocolVersion ProtocolVersion

Ottiene la versione HTTP utilizzata dal client richiedente.Gets the HTTP version used by the requesting client.

QueryString QueryString QueryString QueryString

Ottiene la stringa di query inclusa nella richiesta.Gets the query string included in the request.

RawUrl RawUrl RawUrl RawUrl

Ottiene le informazioni sull'URL (senza host e porta) richieste dal client.Gets the URL information (without the host and port) requested by the client.

RemoteEndPoint RemoteEndPoint RemoteEndPoint RemoteEndPoint

Ottiene l'indirizzo IP e il numero di porta del client da cui ha avuto origine la richiesta.Gets the client IP address and port number from which the request originated.

RequestTraceIdentifier RequestTraceIdentifier RequestTraceIdentifier RequestTraceIdentifier

Ottiene l'identificatore di richiesta della richiesta HTTP in ingresso.Gets the request identifier of the incoming HTTP request.

ServiceName ServiceName ServiceName ServiceName

Ottiene il nome del provider di servizi inviato dal client alla richiesta.Gets the Service Provider Name (SPN) that the client sent on the request.

TransportContext TransportContext TransportContext TransportContext

Ottiene l'oggetto TransportContext per la richiesta del client.Gets the TransportContext for the client request.

Url Url Url Url

Ottiene l'oggetto Uri richiesto dal client.Gets the Uri object requested by the client.

UrlReferrer UrlReferrer UrlReferrer UrlReferrer

Ottiene l'URI della risorsa che ha associato il client al server.Gets the Uniform Resource Identifier (URI) of the resource that referred the client to the server.

UserAgent UserAgent UserAgent UserAgent

Ottiene l'agente utente presentato dal client.Gets the user agent presented by the client.

UserHostAddress UserHostAddress UserHostAddress UserHostAddress

Ottiene l'indirizzo IP e il numero di porta del server a cui è diretta la richiesta.Gets the server IP address and port number to which the request is directed.

UserHostName UserHostName UserHostName UserHostName

Ottiene il nome DNS e, se fornito, il numero di porta specificato dal client.Gets the DNS name and, if provided, the port number specified by the client.

UserLanguages UserLanguages UserLanguages UserLanguages

Ottiene i linguaggi naturali preferiti per la risposta.Gets the natural languages that are preferred for the response.

Metodi

BeginGetClientCertificate(AsyncCallback, Object) BeginGetClientCertificate(AsyncCallback, Object) BeginGetClientCertificate(AsyncCallback, Object) BeginGetClientCertificate(AsyncCallback, Object)

Consente di avviare una richiesta asincrona per il certificato X.509 v.3 del client.Begins an asynchronous request for the client's X.509 v.3 certificate.

EndGetClientCertificate(IAsyncResult) EndGetClientCertificate(IAsyncResult) EndGetClientCertificate(IAsyncResult) EndGetClientCertificate(IAsyncResult)

Consente di terminare una richiesta asincrona per il certificato X.509 v.3 del client.Ends an asynchronous request for the client's X.509 v.3 certificate.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetClientCertificate() GetClientCertificate() GetClientCertificate() GetClientCertificate()

Consente di recuperare il certificato X.509 v.3 del client.Retrieves the client's X.509 v.3 certificate.

GetClientCertificateAsync() GetClientCertificateAsync() GetClientCertificateAsync() GetClientCertificateAsync()

Recupera il certificato X.509 v.3 del client come operazione asincrona.Retrieves the client's X.509 v.3 certificate as an asynchronous operation.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Inherited from Object)

Si applica a

Vedi anche