IHttpContext (interfaz)
Define un objeto que representa el contexto de procesamiento para las operaciones de nivel de solicitud.
Sintaxis
class IHttpContext
Métodos
En la tabla siguiente se enumeran los métodos expuestos por la IHttpContext clase .
| Nombre | Descripción |
|---|---|
| AllocateRequestMemory | Asigna una cantidad de memoria especificada. |
| CancelIo | Cancela las operaciones de envío o recepción pendientes. |
| CloneContext | Crea un clon del contexto de solicitud actual. |
| DisableNotifications | Deshabilita las notificaciones específicas que están pendientes para esta solicitud en el módulo actual. |
| ExecuteRequest | Ejecuta una solicitud secundaria. |
| GetApplication | Recupera el contenedor de aplicaciones para el contexto actual. |
| GetConnection | Recupera el contenedor de conexiones para el contexto actual. |
| GetCurrentExecutionStats | Recupera las estadísticas de ejecución del contexto actual. |
| GetExecuteFlags | Recupera las marcas de ejecución del contexto actual. |
| GetFileInfo | Recupera el contenedor de información del archivo para el contexto actual. |
| GetIsLastNotification | Indica si hay más notificaciones pendientes para esta solicitud dentro del host del módulo actual. |
| GetMetadata | Recupera el contenedor de metadatos para el contexto de solicitud actual. |
| GetModuleContextContainer | Recupera el contenedor de contexto del módulo para el contexto actual. |
| GetNextNotification | Recupera la siguiente notificación para el host del módulo actual. |
| GetParentContext | Recupera un puntero al contexto primario del contexto actual. |
| GetPhysicalPath | Recupera la ruta de acceso física de la solicitud actual. |
| GetRequest | Devuelve el contenedor de solicitudes HTTP para el contexto actual. |
| GetResponse | Devuelve el contenedor de respuesta HTTP para el contexto actual. |
| GetResponseHeadersSent | Determina si los encabezados de respuesta HTTP se han enviado al cliente. |
| GetRootContext | Recupera un puntero al contexto raíz del contexto actual. |
| GetScriptMap | Recupera el contenedor del mapa de scripts para el contexto actual. |
| GetScriptName | Recupera la dirección URL de la solicitud actual. |
| GetScriptTranslated | Recupera la ruta de acceso física de la solicitud actual. |
| GetServerVarChanges | Recupera los cambios en las variables de servidor para el contexto actual. |
| GetServerVariable | Recupera una variable de servidor específica. |
| GetSite | Recupera el contenedor de información del sitio para el contexto actual. |
| GetTraceContext | Recupera el contenedor de contexto de seguimiento para el contexto actual. |
| GetUrlInfo | Recupera el contenedor de información de la dirección URL para el contexto actual. |
| GetUser | Recupera el contenedor de información del usuario para el contexto actual. |
| IndicateCompletion | Indica la finalización del trabajo asincrónico y solicita a IIS que reanude la ejecución en el subproceso que realiza la llamada. |
| MapHandler | Asigna un controlador para una dirección URL, un par de verbos HTTP en un sitio. |
| MapPath | Devuelve la ruta de acceso física de una dirección URL relativa. |
| NotifyCustomNotification | Genera una notificación de nivel de solicitud personalizada. |
| PostCompletion | Indica la finalización del trabajo asincrónico y solicita a IIS que se ejecute en cola en el grupo de subprocesos. |
| ReleaseClonedContext | Libera una instancia clonada IHttpContext . |
| SetRequestHandled | Indica que los controladores de la solicitud actual se han completado. |
| SetServerVariable | Establece una variable de servidor en un valor especificado. |
Clases derivadas
| Nombre | Descripción |
|---|---|
| IHttpContext2 | Representa el reprocesamiento de una solicitud HTTP y habilita la recuperación de información sobre el usuario original durante la operación asincrónica. |
| IHttpContext3 | Representa el reprocesamiento de una solicitud HTTP y permite compatibilidad adicional con las operaciones asincrónicas. |
| IHttpContext4 | Representa el reprocesamiento de una solicitud HTTP y permite compatibilidad adicional con las operaciones de diagnóstico. |
Comentarios
La IHttpContext interfaz representa la interfaz de programación principal de los módulos HTTP para obtener acceso a información sobre el contexto de nivel de solicitud actual. Esta interfaz recupera varias interfaces adicionales que puede usar al escribir módulos HTTP.
Por ejemplo, los GetRequest métodos y GetResponse recuperan, respectivamente, las interfaces IHttpRequest e IHttpResponse para el contexto actual. Estas interfaces permiten a los desarrolladores acceder o modificar el cuerpo y el cuerpo de la respuesta de la solicitud, los encabezados HTTP, el comportamiento del servidor, etc.
IIS 7 permite crear y ejecutar contextos secundarios a través de la IHttpContext interfaz mediante los CloneContextmétodos , ExecuteRequesty ReleaseClonedContext . IIS también proporciona los GetParentContext métodos y GetRootContext para ayudar a los desarrolladores a escribir módulos HTTP que pueden cambiar el comportamiento en función de si el contexto actual es un contexto raíz, secundario o primario.
IHttpContext también proporciona varios métodos para ayudar a los desarrolladores a controlar el comportamiento de las notificaciones. Por ejemplo, puede usar el DisableNotifications método para deshabilitar las notificaciones o el GetIsLastNotification método para determinar si hay notificaciones restantes. Además, puede usar el GetNextNotification método para combinar notificaciones o el NotifyCustomNotification método para generar una notificación personalizada.
Requisitos
| Tipo | Descripción |
|---|---|
| Remoto | - IIS 7.0 en Windows Vista - IIS 7.5 en Windows 7 - IIS 8.0 en Windows 8 - IIS 10.0 en Windows 10 |
| Servidor | - IIS 7.0 en Windows Server 2008 - IIS 7.5 en Windows Server 2008 R2 - IIS 8.0 en Windows Server 2012 - IIS 8.0 en Windows Server 2012 R2 - IIS 10.0 en Windows Server 2016 |
| Producto | - 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 |
| Encabezado | Httpserv.h |