(0) exportieren Drucken
Alle erweitern

HttpListenerContext-Klasse

Aktualisiert: November 2007

Ermöglicht den Zugriff auf die von der HttpListener-Klasse verwendeten Anforderungs- und Antwortobjekte. Diese Klasse kann nicht vererbt werden.

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

public sealed class HttpListenerContext
public final class HttpListenerContext
public final class HttpListenerContext

Diese Klasse stellt die Informationen über eine von einem HttpListener-Objekt verarbeitete HTTP (Hypertext Transfer Protocol)-Anforderung bereit. Die GetContext-Methode gibt Instanzen der HttpListenerContext-Klasse zurück. Um das Objekt abzurufen, das die Clientanforderung darstellt, verwenden Sie die Request-Eigenschaft. Um das Objekt abzurufen, das die vom HttpListener an den Client gesendete Antwort darstellt, verwenden Sie die Response-Eigenschaft. Um Benutzerinformationen über den die Anforderung sendenden Client abzurufen, z. B. den Anmeldenamen und Informationen darüber, ob er authentifiziert wurde, können Sie die Eigenschaften des von der User-Eigenschaft zurückgegebenen IPrincipal-Objekts abfragen.

Durch das Schließen eines HttpListenerContext-Objekts wird die Antwort an den Client gesendet, und alle vom HttpListenerContext verwendeten Ressourcen werden freigegeben. Durch das Abbrechen der Ausführung eines HttpListenerContext-Objekts wird die Antwort an den Client verworfen, sofern sie noch nicht gesendet wurde, und alle vom HttpListenerContext verwendeten Ressourcen werden freigegeben. Nach dem Schließen oder Abbrechen der Ausführung eines HttpListenerContext-Objekts können Sie nicht auf seine Methoden und Eigenschaften verweisen. Wenn Sie dies trotzdem versuchen, erhalten Sie eine ObjectDisposedException-Ausnahme.

Hinweis zu Windows XP Home Edition, Windows XP Professional x64 Edition, Windows Server 2003:

Service Pack 2 ist für die Verwendung der HttpListener-Klasse erforderlich.

Im folgenden Codebeispiel werden die Benutzerinformationen für eine Clientanforderung angezeigt.

public static bool RemoveAllPrefixes(HttpListener listener)
{
    // Get the prefixes that the Web server is listening to.
    HttpListenerPrefixCollection prefixes = listener.Prefixes;
    try 
    {
        prefixes.Clear();
    } 
    // If the operation failed, return false.
    catch
    {
        return false;
    }
    return true;
}


public static boolean RemoveAllPrefixes(HttpListener listener)
{
    // Get the prefixes that the Web server is listening to.
    HttpListenerPrefixCollection prefixes = listener.get_Prefixes();
    try {
        prefixes.Clear();
    }
    // If the operation failed, return false.
    catch (System.Exception exp) {
        return false;
    }
    return true;
} //RemoveAllPrefixes


System.Object
  System.Net.HttpListenerContext

Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

.NET Framework

Unterstützt in: 3.5, 3.0, 2.0

Community-Beiträge

HINZUFÜGEN
Anzeigen:
© 2014 Microsoft