HttpListenerRequest Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Descrive una richiesta HTTP in ingresso a un HttpListener oggetto . Questa classe non può essere ereditata.
public ref class HttpListenerRequest sealedpublic sealed class HttpListenerRequesttype HttpListenerRequest = classPublic NotInheritable Class HttpListenerRequest- Ereditarietà
-
HttpListenerRequest
Esempio
Nell'esempio di codice seguente viene illustrato come ricevere e rispondere a un oggetto 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 URI (Uniform Resource Identifier) gestito da un HttpListener oggetto , HttpListener fornisce un HttpListenerContext oggetto che contiene informazioni sul mittente, la richiesta e la risposta inviata al client. La HttpListenerContext.Request proprietà restituisce l'oggetto HttpListenerRequest che descrive la richiesta.
L'oggetto HttpListenerRequest contiene informazioni sulla richiesta, ad esempio la stringa della richiesta HttpMethod , UserAgent la stringa e i dati del corpo della richiesta (vedere la InputStream proprietà ).
Per rispondere alla richiesta, è necessario ottenere la risposta associata usando la Response proprietà .
Proprietà
| Nome | Descrizione |
|---|---|
| AcceptTypes |
Ottiene i tipi MIME accettati dal client. |
| ClientCertificateError |
Ottiene un codice di errore che identifica un problema con l'oggetto X509Certificate fornito dal client. |
| ContentEncoding |
Ottiene la codifica del contenuto che può essere utilizzata con i dati inviati con la richiesta. |
| ContentLength64 |
Ottiene la lunghezza dei dati del corpo inclusi nella richiesta. |
| ContentType |
Ottiene il tipo MIME dei dati del corpo inclusi nella richiesta. |
| Cookies |
Ottiene i cookie inviati con la richiesta. |
| HasEntityBody |
Ottiene un Boolean valore che indica se la richiesta dispone di dati del corpo associati. |
| Headers |
Ottiene la raccolta di coppie nome/valore di intestazione inviate nella richiesta. |
| HttpMethod |
Ottiene il metodo HTTP specificato dal client. |
| InputStream |
Ottiene un flusso che contiene i dati del corpo inviati dal client. |
| IsAuthenticated |
Ottiene un Boolean valore che indica se il client che invia questa richiesta è autenticato. |
| IsLocal |
Ottiene un Boolean valore che indica se la richiesta viene inviata dal computer locale. |
| IsSecureConnection |
Ottiene un Boolean valore che indica se la connessione TCP utilizzata per inviare la richiesta usa il protocollo SSL (Secure Sockets Layer). |
| IsWebSocketRequest |
Ottiene un Boolean valore che indica se la connessione TCP è una richiesta WebSocket. |
| KeepAlive |
Ottiene un Boolean valore che indica se il client richiede una connessione permanente. |
| LocalEndPoint |
Ottiene l'indirizzo IP del server e il numero di porta a cui viene indirizzata la richiesta. |
| ProtocolVersion |
Ottiene la versione HTTP utilizzata dal client richiedente. |
| QueryString |
Ottiene la stringa di query inclusa nella richiesta. |
| RawUrl |
Ottiene le informazioni sull'URL (senza l'host e la porta) richieste dal client. |
| RemoteEndPoint |
Ottiene l'indirizzo IP del client e il numero di porta da cui ha avuto origine la richiesta. |
| RequestTraceIdentifier |
Ottiene l'identificatore della richiesta HTTP in ingresso. |
| ServiceName |
Ottiene il nome del provider di servizi (SPN) inviato dal client nella richiesta. |
| TransportContext |
Ottiene l'oggetto TransportContext per la richiesta client. |
| Url |
Ottiene l'oggetto Uri richiesto dal client. |
| UrlReferrer |
Ottiene l'URI (Uniform Resource Identifier) della risorsa che ha fatto riferimento al client al server. |
| UserAgent |
Ottiene l'agente utente presentato dal client. |
| UserHostAddress |
Ottiene l'indirizzo IP del server e il numero di porta a cui viene indirizzata la richiesta. |
| UserHostName |
Ottiene il nome DNS e, se specificato, il numero di porta specificato dal client. |
| UserLanguages |
Ottiene i linguaggi naturali preferiti per la risposta. |
Metodi
| Nome | Descrizione |
|---|---|
| BeginGetClientCertificate(AsyncCallback, Object) |
Avvia una richiesta asincrona per il certificato X.509 v.3 del client. |
| EndGetClientCertificate(IAsyncResult) |
Termina una richiesta asincrona per il certificato X.509 v.3 del client. |
| Equals(Object) |
Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object) |
| GetClientCertificate() |
Recupera il certificato X.509 v.3 del client. |
| GetClientCertificateAsync() |
Recupera il certificato X.509 v.3 del client come operazione asincrona. |
| GetHashCode() |
Funge da funzione hash predefinita. (Ereditato da Object) |
| GetType() |
Ottiene il Type dell'istanza corrente. (Ereditato da Object) |
| MemberwiseClone() |
Crea una copia superficiale del Objectcorrente. (Ereditato da Object) |
| ToString() |
Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object) |
