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 |