HttpListenerRequest HttpListenerRequest HttpListenerRequest HttpListenerRequest Class

Definition

Beschreibt eine eingehende HTTP-Anforderung für ein HttpListener-Objekt.Describes an incoming HTTP request to an HttpListener object. Diese Klasse kann nicht vererbt werden.This class cannot be inherited.

public ref class HttpListenerRequest sealed
public sealed class HttpListenerRequest
type HttpListenerRequest = class
Public NotInheritable Class HttpListenerRequest
Vererbung
HttpListenerRequestHttpListenerRequestHttpListenerRequestHttpListenerRequest

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein HttpListenerRequestempfangen und darauf reagiert wird.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

Hinweise

Wenn ein Client eine Anforderung an einen von einem HttpListener -Objekt behandelten Uniform Resource Identifier (URI) sendet HttpListener , stellt ein HttpListenerContext -Objekt bereit, das Informationen über den Absender, die Anforderung und die Antwort enthält, die an den Client gesendet wird.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. Die HttpListenerContext.Request -Eigenschaft gibt HttpListenerRequest das-Objekt zurück, das die Anforderung beschreibt.The HttpListenerContext.Request property returns the HttpListenerRequest object that describes the request.

Das HttpListenerRequest -Objekt enthält Informationen über die Anforderung, z. b HttpMethod . die UserAgent Anforderungs Zeichenfolge, die Zeichenfolge und InputStream die Anforderungs Text Daten (siehe die-Eigenschaft).The HttpListenerRequest object contains information about the request, such as the request HttpMethod string, UserAgent string, and request body data (see the InputStream property).

Um auf die Anforderung zu antworten, müssen Sie die zugehörige Antwort mithilfe Response der-Eigenschaft erhalten.To reply to the request, you must get the associated response using the Response property.

Eigenschaften

AcceptTypes AcceptTypes AcceptTypes AcceptTypes

Ruft die vom Client akzeptierten MIME-Typen ab.Gets the MIME types accepted by the client.

ClientCertificateError ClientCertificateError ClientCertificateError ClientCertificateError

Ruft einen Fehlercode ab, der ein Problem mit dem vom Client bereitgestellten X509Certificate bezeichnet.Gets an error code that identifies a problem with the X509Certificate provided by the client.

ContentEncoding ContentEncoding ContentEncoding ContentEncoding

Ruft die Inhaltscodierung ab, die für mit der Anforderung gesendete Daten verwendet werden kann.Gets the content encoding that can be used with data sent with the request

ContentLength64 ContentLength64 ContentLength64 ContentLength64

Ruft die Länge der in der Anforderung enthaltenen Textdaten ab.Gets the length of the body data included in the request.

ContentType ContentType ContentType ContentType

Ruft den MIME-Typ der in der Anforderung enthaltenen Textdaten ab.Gets the MIME type of the body data included in the request.

Cookies Cookies Cookies Cookies

Ruft die mit der Anforderung gesendeten Cookies ab.Gets the cookies sent with the request.

HasEntityBody HasEntityBody HasEntityBody HasEntityBody

Ruft einen Boolean-Wert ab, der angibt, ob der Anforderung Textdaten zugeordnet sind.Gets a Boolean value that indicates whether the request has associated body data.

Headers Headers Headers Headers

Ruft die Auflistung der in der Anforderung gesendeten Name-Wert-Paare der Header ab.Gets the collection of header name/value pairs sent in the request.

HttpMethod HttpMethod HttpMethod HttpMethod

Ruft die vom Client angegebene HTTP-Methode ab.Gets the HTTP method specified by the client.

InputStream InputStream InputStream InputStream

Ruft einen Stream ab, der die vom Client gesendeten Textdaten enthält.Gets a stream that contains the body data sent by the client.

IsAuthenticated IsAuthenticated IsAuthenticated IsAuthenticated

Ruft einen Boolean-Wert ab, der angibt, ob der diese Anforderung sendende Client authentifiziert ist.Gets a Boolean value that indicates whether the client sending this request is authenticated.

IsLocal IsLocal IsLocal IsLocal

Ruft einen Boolean-Wert ab, der angibt, ob die Anforderung vom lokalen Computer gesendet wurde.Gets a Boolean value that indicates whether the request is sent from the local computer.

IsSecureConnection IsSecureConnection IsSecureConnection IsSecureConnection

Ruft einen Boolean-Wert ab, der angibt, ob die TCP-Verbindung, mit der die Anforderung gesendet wird, das SSL (Secure Sockets Layer)-Protokoll verwendet.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

Ruft einen Boolean-Wert ab, der angibt, ob die TCP Verbindung eine WEbSocket Anforderung war.Gets a Boolean value that indicates whether the TCP connection was a WebSocket request.

KeepAlive KeepAlive KeepAlive KeepAlive

Ruft einen Boolean-Wert ab, der angibt, ob der Client eine permanente Verbindung anfordert.Gets a Boolean value that indicates whether the client requests a persistent connection.

LocalEndPoint LocalEndPoint LocalEndPoint LocalEndPoint

Ruft die IP-Adresse und Anschlussnummer des Servers ab, an den die Anforderung gerichtet ist.Gets the server IP address and port number to which the request is directed.

ProtocolVersion ProtocolVersion ProtocolVersion ProtocolVersion

Ruft die vom anfordernden Client verwendete HTTP-Version ab.Gets the HTTP version used by the requesting client.

QueryString QueryString QueryString QueryString

Ruft die in der Anforderung enthaltene Abfragezeichenfolge ab.Gets the query string included in the request.

RawUrl RawUrl RawUrl RawUrl

Ruft die vom Client angeforderten URL-Informationen (ohne Host und Anschluss) ab.Gets the URL information (without the host and port) requested by the client.

RemoteEndPoint RemoteEndPoint RemoteEndPoint RemoteEndPoint

Ruft die IP-Adresse und Anschlussnummer des Clients ab, von dem die Anforderung stammt.Gets the client IP address and port number from which the request originated.

RequestTraceIdentifier RequestTraceIdentifier RequestTraceIdentifier RequestTraceIdentifier

Ruft den Anforderungsbezeichner der eingehenden HTTP-Anforderung ab.Gets the request identifier of the incoming HTTP request.

ServiceName ServiceName ServiceName ServiceName

Ruft den Dienstanbieternamen (SPN) ab, der vom Client in der Anforderung gesendet wurde.Gets the Service Provider Name (SPN) that the client sent on the request.

TransportContext TransportContext TransportContext TransportContext

Ruft das TransportContext für die Clientanforderung ab.Gets the TransportContext for the client request.

Url Url Url Url

Ruft das vom Client angeforderte Uri-Objekt ab.Gets the Uri object requested by the client.

UrlReferrer UrlReferrer UrlReferrer UrlReferrer

Ruft den URI (Uniform Resource Identifier) der Ressource ab, die den Client an den Server verwiesen hat.Gets the Uniform Resource Identifier (URI) of the resource that referred the client to the server.

UserAgent UserAgent UserAgent UserAgent

Ruft den vom Client dargestellten Benutzer-Agent ab.Gets the user agent presented by the client.

UserHostAddress UserHostAddress UserHostAddress UserHostAddress

Ruft die IP-Adresse und Anschlussnummer des Servers ab, an den die Anforderung gerichtet ist.Gets the server IP address and port number to which the request is directed.

UserHostName UserHostName UserHostName UserHostName

Ruft den DNS-Namen und ggf. die vom Client angegebene Anschlussnummer ab.Gets the DNS name and, if provided, the port number specified by the client.

UserLanguages UserLanguages UserLanguages UserLanguages

Ruft die natürlichen Sprachen ab, die für die Antwort bevorzugt werden.Gets the natural languages that are preferred for the response.

Methoden

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

Beginnt eine asynchrone Anforderung für das X.509 v.3-Zertifikat des Clients.Begins an asynchronous request for the client's X.509 v.3 certificate.

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

Beendet eine asynchrone Anforderung für das X.509 v.3-Zertifikat des Clients.Ends an asynchronous request for the client's X.509 v.3 certificate.

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

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

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

Ruft das X.509 v.3-Zertifikat des Clients ab.Retrieves the client's X.509 v.3 certificate.

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

Ruft das X.509 v.3-Zertifikat des Client als asynchronen Vorgang ab.Retrieves the client's X.509 v.3 certificate as an asynchronous operation.

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

Fungiert als Standardhashfunktion.Serves as the default hash function.

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

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

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

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

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

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)

Gilt für:

Siehe auch