IHttpContext-Schnittstelle

Definiert ein -Objekt, das den Verarbeitungskontext für Vorgänge auf Anforderungsebene darstellt.

Syntax

class IHttpContext  

Methoden

In der folgenden Tabelle sind die Methoden aufgeführt, die von der IHttpContext -Klasse verfügbar gemacht werden.

Name	BESCHREIBUNG
AllocateRequestMemory	Ordnet eine angegebene Menge an Arbeitsspeicher zu.
CancelIo	Bricht alle ausstehenden Sende- oder Empfangsvorgänge ab.
CloneContext	Erstellt einen Klon des aktuellen Anforderungskontexts.
DisableNotifications	Deaktiviert bestimmte Benachrichtigungen, die für diese Anforderung im aktuellen Modul ausstehen.
Executerequest	Führt eine untergeordnete Anforderung aus.
GetApplication	Ruft den Anwendungscontainer für den aktuellen Kontext ab.
GetConnection	Ruft den Verbindungscontainer für den aktuellen Kontext ab.
GetCurrentExecutionStats	Ruft die Ausführungsstatistiken für den aktuellen Kontext ab.
GetExecuteFlags	Ruft die Ausführungsflags für den aktuellen Kontext ab.
Getfileinfo	Ruft den Dateiinformationscontainer für den aktuellen Kontext ab.
GetIsLastNotification	Gibt an, ob weitere Benachrichtigungen für diese Anforderung innerhalb des aktuellen Modulhosts ausstehen.
Getmetadata	Ruft den Metadatencontainer für den aktuellen Anforderungskontext ab.
GetModuleContextContainer	Ruft den Modulkontextcontainer für den aktuellen Kontext ab.
GetNextNotification	Ruft die nächste Benachrichtigung für den aktuellen Modulhost ab.
GetParentContext	Ruft einen Zeiger auf den übergeordneten Kontext für den aktuellen Kontext ab.
GetPhysicalPath	Ruft den physischen Pfad für die aktuelle Anforderung ab.
GetRequest	Gibt den HTTP-Anforderungscontainer für den aktuellen Kontext zurück.
Getresponse	Gibt den HTTP-Antwortcontainer für den aktuellen Kontext zurück.
GetResponseHeadersSent	Bestimmt, ob die HTTP-Antwortheader an den Client gesendet wurden.
GetRootContext	Ruft einen Zeiger auf den Stammkontext für den aktuellen Kontext ab.
GetScriptMap	Ruft den Skriptzuordnungscontainer für den aktuellen Kontext ab.
GetScriptName	Ruft die URL für die aktuelle Anforderung ab.
GetScriptTranslated	Ruft den physischen Pfad der aktuellen Anforderung ab.
GetServerVarChanges	Ruft die Änderungen an den Servervariablen für den aktuellen Kontext ab.
GetServerVariable	Ruft eine bestimmte Servervariable ab.
GetSite	Ruft den Standortinformationscontainer für den aktuellen Kontext ab.
GetTraceContext	Ruft den Ablaufverfolgungskontextcontainer für den aktuellen Kontext ab.
GetUrlInfo	Ruft den URL-Informationscontainer für den aktuellen Kontext ab.
Getuser	Ruft den Benutzerinformationscontainer für den aktuellen Kontext ab.
IndicateCompletion	Gibt den Abschluss asynchroner Arbeiten an und fordert IIS an, die Ausführung im aufrufenden Thread fortzusetzen.
MapHandler	Ordnet einen Handler für eine Geben-URL und ein HTTP-Verbpaar auf einer Website zu.
MapPath	Gibt den physischen Pfad einer relativen URL zurück.
NotifyCustomNotification	Löst eine benutzerdefinierte Benachrichtigung auf Anforderungsebene aus.
PostCompletion	Gibt den Abschluss asynchroner Arbeiten an und fordert IIS an, die Ausführung in einer Warteschlange für den Threadpool auszuführen.
ReleaseClonedContext	Gibt eine geklonte IHttpContext instance frei.
SetRequestHandled	Gibt an, dass die Handler für die aktuelle Anforderung abgeschlossen sind.
SetServerVariable	Legt eine Servervariable auf einen angegebenen Wert fest.

Abgeleitete Klassen

Name	BESCHREIBUNG
IHttpContext2	Stellt die Erneute Verarbeitung einer HTTP-Anforderung dar und ermöglicht das Abrufen von Informationen über den ursprünglichen Benutzer während des asynchronen Vorgangs.
IHttpContext3	Stellt die Erneute Verarbeitung einer HTTP-Anforderung dar und ermöglicht zusätzliche Unterstützung für asynchrone Vorgänge.
IHttpContext4	Stellt die Erneute Verarbeitung einer HTTP-Anforderung dar und ermöglicht zusätzliche Unterstützung für Diagnosevorgänge.

Bemerkungen

Die IHttpContext Schnittstelle stellt die Standard programmgesteuerte Schnittstelle für HTTP-Module dar, um auf Informationen über den aktuellen Kontext auf Anforderungsebene zuzugreifen. Diese Schnittstelle ruft mehrere zusätzliche Schnittstellen ab, die Sie beim Schreiben von HTTP-Modulen verwenden können.

Die Methoden und GetResponse rufen beispielsweise GetRequest die IHttpRequest- bzw. IHttpResponse-Schnittstelle für den aktuellen Kontext ab. Diese Schnittstellen ermöglichen Es Entwicklern, auf den Anforderungstext und antworttext, HTTP-Header, Das Serververhalten usw. zuzugreifen oder zu ändern.

IIS 7 ermöglicht das Erstellen und Ausführen untergeordneter Kontexte über die IHttpContext Schnittstelle mithilfe der CloneContextMethoden , ExecuteRequestund ReleaseClonedContext . IIS stellt auch die GetParentContext Methoden und GetRootContext bereit, um Entwicklern beim Schreiben von HTTP-Modulen zu helfen, die das Verhalten ändern können, je nachdem, ob der aktuelle Kontext ein Stamm-, untergeordneter oder übergeordneter Kontext ist.

IHttpContext bietet außerdem mehrere Methoden, mit denen Entwickler das Verhalten von Benachrichtigungen steuern können. Sie können beispielsweise die DisableNotifications -Methode verwenden, um Benachrichtigungen zu deaktivieren, oder die GetIsLastNotification -Methode, um zu bestimmen, ob verbleibende Benachrichtigungen vorhanden sind. Darüber hinaus können Sie die GetNextNotification -Methode zum Zusammenführen von Benachrichtigungen oder die NotifyCustomNotification Methode verwenden, um eine benutzerdefinierte Benachrichtigung auszulösen.

Anforderungen

type	BESCHREIBUNG
Client	– IIS 7.0 unter Windows Vista – IIS 7.5 unter Windows 7 – IIS 8.0 unter Windows 8 – IIS 10.0 auf Windows 10
Server	– IIS 7.0 unter Windows Server 2008 – IIS 7.5 unter Windows Server 2008 R2 – IIS 8.0 unter Windows Server 2012 – IIS 8.0 unter Windows Server 2012 R2 – IIS 10.0 auf Windows Server 2016
Produkt	– IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0 - IIS Express 7.5, IIS Express 8.0, IIS Express 10.0
Header	Httpserv.h

Weitere Informationen

Webserverkernschnittstellen