Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

HttpListenerRequest-Klasse

 

Veröffentlicht: Oktober 2016

Beschreibt eine eingehende HTTP-Anforderung für ein HttpListener Objekt. Diese Klasse kann nicht vererbt werden.

Namespace:   System.Net
Assembly:  System (in System.dll)

System.Object
  System.Net.HttpListenerRequest

public sealed class HttpListenerRequest

NameBeschreibung
System_CAPS_pubpropertyAcceptTypes

Ruft die MIME-Typen, die vom Client akzeptiert.

System_CAPS_pubpropertyClientCertificateError

Ruft einen Fehlercode, der ein Problem mit identifiziert die X509Certificate vom Client bereitgestellt.

System_CAPS_pubpropertyContentEncoding

Ruft die Codierung des Inhalts, die mit der Anforderung gesendeten Daten verwendet werden können

System_CAPS_pubpropertyContentLength64

Ruft die Länge der Textdaten in der Anforderung enthalten.

System_CAPS_pubpropertyContentType

Ruft den MIME-Typ in der Anforderung enthaltenen Textdaten ab.

System_CAPS_pubpropertyCookies

Ruft die mit der Anforderung gesendeten Cookies ab.

System_CAPS_pubpropertyHasEntityBody

Ruft einen Boolean -Wert, der angibt, ob der Anforderung Textdaten zugeordnet sind.

System_CAPS_pubpropertyHeaders

Ruft die Auflistung von Name/Wert-Paaren für Header in der Anforderung gesendet.

System_CAPS_pubpropertyHttpMethod

Ruft die vom Client angegebene HTTP-Methode ab.

System_CAPS_pubpropertyInputStream

Ruft einen Stream, der vom Client gesendeten Textdaten enthält.

System_CAPS_pubpropertyIsAuthenticated

Ruft ein Boolean Wert, der angibt, ob der Client sendet diese Anforderung authentifiziert wurde.

System_CAPS_pubpropertyIsLocal

Ruft ein Boolean Wert, der angibt, ob die Anforderung vom lokalen Computer gesendet wird.

System_CAPS_pubpropertyIsSecureConnection

Ruft einen Boolean -Wert, der angibt, ob die TCP-Verbindung zum Senden der Anforderung das Protokoll Secure Sockets Layer (SSL) verwendet wird.

System_CAPS_pubpropertyIsWebSocketRequest

Ruft einen Boolean -Wert, der angibt, ob die TCP-Verbindung eine WebSocket-Anforderung war.

System_CAPS_pubpropertyKeepAlive

Ruft einen Boolean -Wert, der angibt, ob der Client eine permanente Verbindung anfordert.

System_CAPS_pubpropertyLocalEndPoint

Abrufen des Servers-IP-Adresse und Port-Nummer an den die Anforderung gerichtet ist.

System_CAPS_pubpropertyProtocolVersion

Ruft die vom anfordernden Client verwendete HTTP-Version ab.

System_CAPS_pubpropertyQueryString

Ruft die Abfragezeichenfolge, die in der Anforderung enthalten.

System_CAPS_pubpropertyRawUrl

Ruft die URL-Informationen (ohne Host und Port) vom Client angefordert werden.

System_CAPS_pubpropertyRemoteEndPoint

Ruft die Client-IP-Adresse und Port-Nummer von dem die Anforderung stammt.

System_CAPS_pubpropertyRequestTraceIdentifier

Ruft den Anforderungsbezeichner der eingehenden HTTP-Anforderung ab.

System_CAPS_pubpropertyServiceName

Ruft den Dienstanbieternamen (SPN), die der Client in der Anforderung gesendet.

System_CAPS_pubpropertyTransportContext

Ruft die TransportContext für die Clientanforderung.

System_CAPS_pubpropertyUrl

Ruft die Uri vom Client angeforderten Objekt.

System_CAPS_pubpropertyUrlReferrer

Ruft den Uniform Resource Identifier (URI) der Ressource, die den Client an den Server verwiesen.

System_CAPS_pubpropertyUserAgent

Ruft die Benutzer-Agent, der vom Client ab.

System_CAPS_pubpropertyUserHostAddress

Ruft die IP-Adresse und Port-Nummer an den die Anforderung gerichtet ist ab.

System_CAPS_pubpropertyUserHostName

Ruft den DNS-Namen und, falls angegeben, wird die Portnummer vom Client angegeben.

System_CAPS_pubpropertyUserLanguages

Ruft die natürlichen Sprachen, die für die Antwort bevorzugt werden.

NameBeschreibung
System_CAPS_pubmethodBeginGetClientCertificate(AsyncCallback, Object)

Beginnt eine asynchrone Anforderung für das Zertifikat des Clients x. 509 v. 3.

System_CAPS_pubmethodEndGetClientCertificate(IAsyncResult)

Beendet eine asynchrone Anforderung für das Zertifikat des Clients x. 509 v. 3.

System_CAPS_pubmethodEquals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.(Geerbt von „Object“.)

System_CAPS_pubmethodGetClientCertificate()

Ruft den Client x. 509 v. 3-Zertifikat ab.

System_CAPS_pubmethodGetClientCertificateAsync()

Ruft den Client x. 509 v. 3-Zertifikat als einen asynchronen Vorgang ab.

System_CAPS_pubmethodGetHashCode()

Fungiert als die Standardhashfunktion.(Geerbt von „Object“.)

System_CAPS_pubmethodGetType()

Ruft den Type der aktuellen Instanz ab.(Geerbt von „Object“.)

System_CAPS_pubmethodToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.(Geerbt von „Object“.)

Wenn ein Client eine Anforderung an einen Uniform Resource Identifier (URI) stellt behandelt, indem ein HttpListener -Objekt, die HttpListener bietet ein HttpListenerContext -Objekt, das enthält Informationen über den Absender, die Anforderung und die Antwort, die an den Client gesendet wird. Die HttpListenerContext.Request -Eigenschaft gibt die HttpListenerRequest -Objekt, das die Anforderung beschreibt.

Die HttpListenerRequest -Objekt enthält Informationen über die Anforderung, z. B. die HttpMethod Zeichenfolge UserAgent Zeichenfolge, und fordern Sie Textdaten (finden Sie unter der InputStream Eigenschaft).

Um die Anforderung zu antworten, benötigen Sie die zugeordnete Antwort mithilfe der Response Eigenschaft.

Im folgenden Codebeispiel wird veranschaulicht, wie zum Empfangen und reagieren auf eine 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();
}

.NET Framework
Verfügbar seit 2.0

Alle öffentlichen statischen Member ( Shared in Visual Basic) dieses Typs sind threadsicher. Die Threadsicherheit für Instanzmember ist nicht garantiert.

Zurück zum Anfang
Anzeigen: