Dieser Artikel wurde noch nicht bewertet - Dieses Thema bewerten.

HttpListenerRequest-Klasse

Hinweis: Diese Klasse ist neu in .NET Framework, Version 2.0.

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

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

public sealed class HttpListenerRequest
public final class HttpListenerRequest
public final class HttpListenerRequest

Wenn ein Client eine Anforderung an einen URI (Uniform Resource Identifier) ausführt, der von einem HttpListener-Objekt behandelt wird, stellt der HttpListener ein HttpListenerContext-Objekt bereit, das Informationen über den Absender, die Anforderung und die an den Client gesendete Antwort enthält. Die HttpListenerContext.Request-Eigenschaft gibt das HttpListenerRequest-Objekt zurück, das die Anforderung beschreibt.

Das HttpListenerRequest-Objekt enthält Informationen über die Anforderung, z. B. die HttpMethod-Zeichenfolge, die UserAgent-Zeichenfolge und die Textdaten der Anforderung (siehe die InputStream-Eigenschaft).

Um auf die Anforderung zu antworten, müssen Sie die zugeordnete Antwort mithilfe der Response-Eigenschaft abrufen.

Im folgenden Codebeispiel wird beschrieben, wie eine HttpListenerRequest empfangen und auf diese geantwortet wird.

// 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();
}

System.Object
  System.Net.HttpListenerRequest
Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Windows 98, Windows Server 2003, Windows XP Media Center Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

.NET Framework

Unterstützt in: 2.0
Fanden Sie dies hilfreich?
(1500 verbleibende Zeichen)
© 2013 Microsoft. Alle Rechte vorbehalten.