HttpListenerRequest HttpListenerRequest HttpListenerRequest HttpListenerRequest Class

Definition

Beschreibt eine eingehende HTTP-Anforderung für eine 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 zum Empfangen und reagieren auf eine HttpListenerRequest.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 Uniform Resource Identifier (URI) stellt behandelt, indem ein HttpListener -Objekt, das HttpListener bietet eine HttpListenerContext -Objekt mit Informationen zu der Absender der Anforderung und die Antwort, 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 die HttpListenerRequest Objekt, das die Anforderung beschreibt.The HttpListenerContext.Request property returns the HttpListenerRequest object that describes the request.

Die HttpListenerRequest Objekt enthält Informationen über die Anforderung, z. B. die Anforderung HttpMethod Zeichenfolge UserAgent Zeichenfolge ein, und fordern Sie Textdaten (finden Sie unter den InputStream 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 die Anforderung Antworten, müssen Sie abrufen, die zugehörige Antwort mithilfe der Response Eigenschaft.To reply to the request, you must get the associated response using the Response property.

Eigenschaften

AcceptTypes AcceptTypes AcceptTypes AcceptTypes

Ruft die MIME-Typen, die vom Client akzeptiert.Gets the MIME types accepted by the client.

ClientCertificateError ClientCertificateError ClientCertificateError ClientCertificateError

Ruft einen Fehlercode, der ein Problem mit identifiziert die X509Certificate vom Client bereitgestellt wird.Gets an error code that identifies a problem with the X509Certificate provided by the client.

ContentEncoding ContentEncoding ContentEncoding ContentEncoding

Ruft die inhaltscodierung, die mit der Anforderung gesendeten Daten verwendet werden könnenGets 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 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 eine Boolean Wert, der angibt, ob es sich bei 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 von Name/Wert-Paaren für Header in der Anforderung gesendet.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, der vom Client gesendeten Textdaten enthält.Gets a stream that contains the body data sent by the client.

IsAuthenticated IsAuthenticated IsAuthenticated IsAuthenticated

Ruft eine Boolean Wert, der angibt, ob es sich bei der diese Anforderung sendende Client authentifiziert wird.Gets a Boolean value that indicates whether the client sending this request is authenticated.

IsLocal IsLocal IsLocal IsLocal

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

IsSecureConnection IsSecureConnection IsSecureConnection IsSecureConnection

Ruft eine Boolean Wert, der angibt, ob die TCP-Verbindung zum Senden der Anforderung das Protokoll Secure Sockets Layer (SSL) verwendet wird.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 eine Boolean Wert, der angibt, ob die TCP-Verbindung eine websocketanforderung war.Gets a Boolean value that indicates whether the TCP connection was a WebSocket request.

KeepAlive KeepAlive KeepAlive KeepAlive

Ruft eine Boolean Wert, 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 Port-Nummer, der die Anforderung gerichtet ist, ab.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 URL-Informationen (ohne den Host und Port) vom Client angefordert werden.Gets the URL information (without the host and port) requested by the client.

RemoteEndPoint RemoteEndPoint RemoteEndPoint RemoteEndPoint

Ruft die IP-Adresse und die Anschlussnummer aus der die Anforderung stammt ab.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 ab, der Dienstanbieternamen (SPN), die 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 die TransportContext für die Clientanforderung.Gets the TransportContext for the client request.

Url Url Url Url

Ruft die Uri vom Client angeforderte Objekt.Gets the Uri object requested by the client.

UrlReferrer UrlReferrer UrlReferrer UrlReferrer

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

UserAgent UserAgent UserAgent UserAgent

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

UserHostAddress UserHostAddress UserHostAddress UserHostAddress

Ruft die IP-Adresse und Port-Nummer, der die Anforderung gerichtet ist, ab.Gets the server IP address and port number to which the request is directed.

UserHostName UserHostName UserHostName UserHostName

Ruft den DNS-Namen und, falls angegeben, wird die Portnummer durch den Client angegeben.Gets the DNS name and, if provided, the port number specified by the client.

UserLanguages UserLanguages UserLanguages UserLanguages

Ruft die natürlichen Sprachen, 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 Zertifikat des Clients x. 509 v. 3.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 Zertifikat des Clients x. 509 v. 3.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 ab, das Zertifikat des Clients x. 509 v. 3.Retrieves the client's X.509 v.3 certificate.

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

Ruft das x. 509 v. 3 Clientzertifikat als einen 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