IHttpStoredContext-Schnittstelle
Definiert Kontextinformationen für gespeicherte Daten.
Syntax
class IHttpStoredContext
Methoden
In der folgenden Tabelle werden die Methoden aufgelistet, die von der IHttpStoredContext
-Klasse verfügbar gemacht werden.
Name | Beschreibung |
---|---|
CleanupStoredContext | Bereinigt den gespeicherten Kontext. |
Abgeleitete Klassen
Name | Beschreibung |
---|---|
IWebSocketContext | Stellt die Kontextunterstützung für bidirektionale WebSocket-Kommunikation über einen einzelnen TCP-Socket dar. |
Hinweise
Viele IIS 7-Klassen verwalten einen private
IDispensedHttpModuleContextContainer-Zeiger als Membervariable. Diese Klassen implementieren verschiedene Schnittstellen, einschließlich IHttpApplication, IHttpConnection, IHttpContext, IHttpFileInfo, IHttpSite, IHttpUrlInfo und IMetadataInfo.
Jede dieser Schnittstellen definiert eine GetModuleContextContainer
Methode, die keine Argumente akzeptiert und einen IHttpModuleContextContainer-Zeiger zurückgibt. Wenn die verschiedenen GetModuleContextContainer
Methoden aufgerufen werden, geben die meisten dieser Implementierer die private
Daten als Upcast IHttpModuleContextContainer
zurück. Auf diese Weise können die Schnittstellenimplementierer benutzerdefinierte Container verfügbar machen und gleichzeitig die Lebensdauer dieser Container beibehalten.
Sie können benutzerdefinierte Klassen definieren, die die IHttpStoredContext
Schnittstelle implementieren und dann einen Zeiger auf diese IHttpStoredContext
Klassenimplementierer erstellen, indem Sie den new
Operator aufrufen. Anschließend können Sie diesen Zeiger zu einem IHttpModuleContextContainer
Zeiger hinzufügen und abrufen, indem Sie die Methoden "IHttpModuleContextContainer::SetModuleContext " bzw . "IHttpModuleContextContainer::GetModuleContext " aufrufen.
Wenn der IHttpStoredContext
Zeiger nicht mehr benötigt wird, wird die CleanupStoredContext
Methode intern aufgerufen, wobei der Implementierer der Schnittstellenmethode in der IHttpStoredContext
Regel aufgerufen delete``this
werden soll.
Achtung
Obwohl es sich um einen sicheren Vorgang handelt, um einen IHttpModuleContextContainer
IDispensedHttpModuleContextContainer
Vorgang mithilfe des dynamic_cast-Operators zu downcasten, sollten Sie diese Umwandlung vermeiden. Die IDispensedHttpModuleContextContainer
Schnittstelle fügt nur eine Methode, ReleaseContainer, zur Basisschnittstelle hinzu, und diese Methode sollte nur intern aufgerufen werden.
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 unter Windows 10 |
Server | IIS 7.0 unter Windows Server 2008 - IIS 7.5 unter Windows Server 2008 R2 IIS 8.0 auf Windows Server 2012. - IIS 8.5 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 |