Интерфейс IHttpContext
Определяет объект , представляющий контекст обработки для операций на уровне запроса.
Синтаксис
class IHttpContext
Методы
В следующей таблице перечислены методы, предоставляемые классом IHttpContext .
| Имя | Описание |
|---|---|
| AllocateRequestMemory | Выделяет указанный объем памяти. |
| CancelIo | Отменяет все ожидающие операции отправки или получения. |
| CloneContext | Создает клон текущего контекста запроса. |
| DisableNotifications | Отключает определенные уведомления, ожидающие выполнения этого запроса в текущем модуле. |
| ExecuteRequest | Выполняет дочерний запрос. |
| GetApplication | Извлекает контейнер приложения для текущего контекста. |
| GetConnection | Извлекает контейнер подключения для текущего контекста. |
| GetCurrentExecutionStats | Извлекает статистику выполнения для текущего контекста. |
| GetExecuteFlags | Извлекает флаги выполнения для текущего контекста. |
| GetFileInfo | Извлекает контейнер сведений о файле для текущего контекста. |
| GetIsLastNotification | Указывает, ожидаются ли дополнительные уведомления для этого запроса в текущем узле модуля. |
| GetMetadata | Извлекает контейнер метаданных для текущего контекста запроса. |
| GetModuleContextContainer | Извлекает контейнер контекста модуля для текущего контекста. |
| GetNextNotification | Извлекает следующее уведомление для текущего узла модуля. |
| GetParentContext | Извлекает указатель на родительский контекст для текущего контекста. |
| GetPhysicalPath | Извлекает физический путь для текущего запроса. |
| GetRequest | Возвращает контейнер HTTP-запросов для текущего контекста. |
| Getresponse | Возвращает контейнер HTTP-ответа для текущего контекста. |
| GetResponseHeadersSent | Определяет, были ли отправлены клиенту заголовки HTTP-ответа. |
| GetRootContext | Извлекает указатель на корневой контекст для текущего контекста. |
| GetScriptMap | Извлекает контейнер карты скрипта для текущего контекста. |
| GetScriptName | Извлекает URL-адрес для текущего запроса. |
| GetScriptTranslated | Извлекает физический путь к текущему запросу. |
| GetServerVarChanges | Извлекает изменения переменных сервера для текущего контекста. |
| GetServerVariable | Извлекает определенную переменную сервера. |
| GetSite | Извлекает контейнер сведений о сайте для текущего контекста. |
| GetTraceContext | Извлекает контейнер контекста трассировки для текущего контекста. |
| GetUrlInfo | Извлекает контейнер сведений о URL-адресе для текущего контекста. |
| Getuser | Извлекает контейнер сведений о пользователе для текущего контекста. |
| IndicateCompletion | Указывает на завершение асинхронной работы и запрашивает у СЛУЖБ IIS возобновление выполнения в вызывающем потоке. |
| MapHandler | Сопоставляет обработчик для дающего URL-адреса и пары HTTP-команд на сайте. |
| Mappath | Возвращает физический путь относительного URL-адреса. |
| NotifyCustomNotification | Создает настраиваемое уведомление уровня запроса. |
| PostCompletion | Указывает на завершение асинхронной работы и запрашивает у СЛУЖБ IIS выполнение в очереди в пул потоков. |
| ReleaseClonedContext | Освобождает клонированные экземпляры IHttpContext . |
| SetRequestHandled | Указывает, что обработчики для текущего запроса завершены. |
| SetServerVariable | Задает для переменной сервера указанное значение. |
Производные классы
| Имя | Описание |
|---|---|
| IHttpContext2 | Представляет повторную обработку HTTP-запроса и позволяет получать сведения об исходном пользователе во время асинхронной операции. |
| IHttpContext3 | Представляет повторную обработку HTTP-запроса и обеспечивает дополнительную поддержку асинхронных операций. |
| IHttpContext4 | Представляет повторную обработку HTTP-запроса и обеспечивает дополнительную поддержку диагностических операций. |
Комментарии
Интерфейс IHttpContext представляет main программного интерфейса для модулей HTTP для доступа к сведениям о текущем контексте уровня запроса. Этот интерфейс извлекает несколько дополнительных интерфейсов, которые можно использовать при написании модулей HTTP.
Например, GetRequest методы и GetResponse извлекают соответственно интерфейсы IHttpRequest и IHttpResponse для текущего контекста. Эти интерфейсы позволяют разработчикам получать доступ к тексту запроса и тексту ответа, заголовкам HTTP, поведению сервера и т. д.
СЛУЖБЫ IIS 7 позволяют создавать и выполнять дочерние контексты через IHttpContext интерфейс с помощью CloneContextметодов , ExecuteRequestи ReleaseClonedContext . СЛУЖБЫ IIS также предоставляют GetParentContext методы и GetRootContext , помогающие разработчикам создавать http-модули, которые могут изменять поведение в зависимости от того, является ли текущий контекст корневым, дочерним или родительским.
IHttpContext также предоставляет несколько методов, помогающих разработчикам управлять поведением уведомлений. Например, можно использовать DisableNotifications метод для отключения уведомлений или метод , GetIsLastNotification чтобы определить, есть ли оставшиеся уведомления. Кроме того, можно использовать GetNextNotification метод для уведомлений слиянием NotifyCustomNotification или метод для создания настраиваемого уведомления.
Требования
| Тип | Описание |
|---|---|
| клиент | — IIS 7.0 в Windows Vista — IIS 7.5 в Windows 7 — IIS 8.0 в Windows 8 — IIS 10.0 в Windows 10 |
| Сервер | — IIS 7.0 в Windows Server 2008 — IIS 7.5 в Windows Server 2008 R2 — IIS 8.0 в Windows Server 2012 — IIS 8.0 в Windows Server 2012 R2 — IIS 10.0 в Windows Server 2016 |
| Продукт | — 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 |
| Заголовок | Httpserv.h |