Интерфейс 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

См. также:

Основные интерфейсы веб-сервера