HttpWorkerRequest Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Этот абстрактный класс определяет базовые рабочие методы и перечисления, используемые ASP.NET управляемым кодом для обработки запросов.
public ref class HttpWorkerRequest abstract
[System.Runtime.InteropServices.ComVisible(false)]
public abstract class HttpWorkerRequest
[<System.Runtime.InteropServices.ComVisible(false)>]
type HttpWorkerRequest = class
Public MustInherit Class HttpWorkerRequest
- Наследование
-
HttpWorkerRequest
- Производный
- Атрибуты
Комментарии
В большинстве случаев код не будет иметь дело HttpWorkerRequest напрямую, так как данные запроса и ответа предоставляются через HttpRequest и HttpResponse классы. Некоторые внутренние ASP.NET классы расширяют этот класс. Если код реализует собственную среду размещения, необходимо расширить этот класс для вызова ProcessRequest метода. Кроме того, код может создать производный класс для целей выполнения дочернего запроса в данном приложении, чтобы передать его экземпляр ProcessRequest. В этом случае производный класс должен содержать ссылку на текущий HttpWorkerRequest и делегировать большинство методов к нему.
Конструкторы
| Имя | Описание |
|---|---|
| HttpWorkerRequest() |
Инициализирует новый экземпляр класса HttpWorkerRequest. |
Поля
| Имя | Описание |
|---|---|
| HeaderAccept |
Указывает номер индекса для заголовка |
| HeaderAcceptCharset |
Указывает номер индекса для заголовка |
| HeaderAcceptEncoding |
Указывает номер индекса для заголовка |
| HeaderAcceptLanguage |
Указывает номер индекса для заголовка |
| HeaderAcceptRanges |
Указывает номер индекса для заголовка |
| HeaderAge |
Указывает номер индекса для заголовка |
| HeaderAllow |
Указывает номер индекса для заголовка |
| HeaderAuthorization |
Указывает номер индекса для заголовка |
| HeaderCacheControl |
Индекс, представляющий заголовок HTTP HTTP |
| HeaderConnection |
Указывает номер индекса для заголовка |
| HeaderContentEncoding |
Указывает номер индекса для заголовка |
| HeaderContentLanguage |
Указывает номер индекса для заголовка |
| HeaderContentLength |
Указывает номер индекса для заголовка |
| HeaderContentLocation |
Указывает номер индекса для заголовка |
| HeaderContentMd5 |
Указывает номер индекса для заголовка |
| HeaderContentRange |
Указывает номер индекса для заголовка |
| HeaderContentType |
Указывает номер индекса для заголовка |
| HeaderCookie |
Указывает номер индекса для заголовка |
| HeaderDate |
Указывает номер индекса для заголовка |
| HeaderEtag |
Указывает номер индекса для заголовка |
| HeaderExpect |
Указывает номер индекса для заголовка |
| HeaderExpires |
Указывает номер индекса для заголовка |
| HeaderFrom |
Указывает номер индекса для заголовка |
| HeaderHost |
Указывает номер индекса для заголовка |
| HeaderIfMatch |
Указывает номер индекса для заголовка |
| HeaderIfModifiedSince |
Указывает номер индекса для заголовка |
| HeaderIfNoneMatch |
Указывает номер индекса для заголовка |
| HeaderIfRange |
Указывает номер индекса для заголовка |
| HeaderIfUnmodifiedSince |
Указывает номер индекса для заголовка |
| HeaderKeepAlive |
Указывает номер индекса для заголовка |
| HeaderLastModified |
Указывает номер индекса для заголовка |
| HeaderLocation |
Указывает номер индекса для заголовка |
| HeaderMaxForwards |
Указывает номер индекса для заголовка |
| HeaderPragma |
Указывает номер индекса для заголовка |
| HeaderProxyAuthenticate |
Указывает номер индекса для заголовка |
| HeaderProxyAuthorization |
Указывает номер индекса для заголовка |
| HeaderRange |
Указывает номер индекса для заголовка |
| HeaderReferer |
Указывает номер индекса для заголовка |
| HeaderRetryAfter |
Указывает номер индекса для заголовка |
| HeaderServer |
Указывает номер индекса для заголовка |
| HeaderSetCookie |
Указывает номер индекса для заголовка |
| HeaderTe |
Указывает номер индекса для заголовка |
| HeaderTrailer |
Указывает номер индекса для заголовка |
| HeaderTransferEncoding |
Указывает номер индекса для заголовка |
| HeaderUpgrade |
Указывает номер индекса для заголовка |
| HeaderUserAgent |
Указывает номер индекса для заголовка |
| HeaderVary |
Указывает номер индекса для заголовка |
| HeaderVia |
Указывает номер индекса для заголовка |
| HeaderWarning |
Указывает номер индекса для заголовка |
| HeaderWwwAuthenticate |
Указывает номер индекса для заголовка |
| ReasonCachePolicy |
Указывает причину запроса. |
| ReasonCacheSecurity |
Указывает причину запроса. |
| ReasonClientDisconnect |
Указывает причину запроса. |
| ReasonDefault |
Указывает причину запроса. Значение по умолчанию — ReasonResponseCacheMiss. |
| ReasonFileHandleCacheMiss |
Указывает причину запроса. |
| ReasonResponseCacheMiss |
Указывает причину запроса. |
| RequestHeaderMaximum |
Указывает номер индекса для заголовка |
| ResponseHeaderMaximum |
Указывает номер индекса для заголовка |
Свойства
| Имя | Описание |
|---|---|
| MachineConfigPath |
Возвращает полный физический путь к файлу Machine.config. |
| MachineInstallDirectory |
Возвращает физический путь к каталогу, в котором установлены двоичные файлы ASP.NET. |
| RequestTraceIdentifier |
Возвращает соответствующий идентификатор трассировки событий для Windows для текущего запроса. |
| RootWebConfigPath |
Возвращает полный физический путь к корневому Web.config-файлу. |
| SupportsAsyncFlush |
Возвращает значение, указывающее, поддерживаются ли асинхронные операции очистки. |
| SupportsAsyncRead |
Возвращает значение, указывающее, поддерживаются ли асинхронные операции чтения. |
Методы
| Имя | Описание |
|---|---|
| BeginFlush(AsyncCallback, Object) |
Отправляет клиенту буферный ответ. |
| BeginRead(Byte[], Int32, Int32, AsyncCallback, Object) |
Начинает асинхронную операцию чтения текста сущности запроса. |
| CloseConnection() |
Завершает соединение с клиентом. |
| EndFlush(IAsyncResult) |
Ожидает завершения ожидающей асинхронной операции очистки. |
| EndOfRequest() |
Используется средой выполнения для уведомления HttpWorkerRequest о завершении обработки запроса для текущего запроса. |
| EndRead(IAsyncResult) |
Ожидает завершения ожидающей асинхронной операции чтения. |
| Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
| FlushResponse(Boolean) |
Отправляет все ожидающие данные ответа клиенту. |
| GetAppPath() |
Возвращает виртуальный путь к выполняющимся в данный момент серверным приложением. |
| GetAppPathTranslated() |
Возвращает физический путь к выполняющимся в данный момент серверным приложением. |
| GetAppPoolID() |
При переопределении в производном классе возвращает идентификатор пула приложений для текущего URL-адреса. |
| GetBytesRead() |
Возвращает количество байтов, считываемых из клиента. |
| GetClientCertificate() |
При переопределении в производном классе получает поля сертификации (указанные в стандарте X.509) из запроса, выданного клиентом. |
| GetClientCertificateBinaryIssuer() |
Возвращает издателя сертификата в двоичном формате. |
| GetClientCertificateEncoding() |
При переопределении в производном классе возвращает Encoding объект, в котором был закодирован сертификат клиента. |
| GetClientCertificatePublicKey() |
При переопределении в производном классе получает объект, связанный |
| GetClientCertificateValidFrom() |
При переопределении в производном классе получает дату, когда сертификат становится допустимым. Дата зависит от международных параметров. |
| GetClientCertificateValidUntil() |
Возвращает дату окончания срока действия сертификата. |
| GetConnectionID() |
При переопределении в производном классе возвращает идентификатор текущего подключения. |
| GetFilePath() |
При переопределении в производном классе возвращает виртуальный путь к запрошенным URI. |
| GetFilePathTranslated() |
Возвращает путь к запрошенным URI физического файла (и преобразует его из виртуального пути к физическому пути: например, "/proj1/page.aspx" в "c:\dir\page.aspx") |
| GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
| GetHttpVerbName() |
Возвращает указанный элемент заголовка запроса. |
| GetHttpVersion() |
Предоставляет доступ к версии HTTP запроса (например, HTTP/1.1). |
| GetKnownRequestHeader(Int32) |
Возвращает стандартный заголовок HTTP-запроса, соответствующий указанному индексу. |
| GetKnownRequestHeaderIndex(String) |
Возвращает номер индекса указанного заголовка HTTP-запроса. |
| GetKnownRequestHeaderName(Int32) |
Возвращает имя указанного заголовка HTTP-запроса. |
| GetKnownResponseHeaderIndex(String) |
Возвращает номер индекса указанного заголовка ответа HTTP. |
| GetKnownResponseHeaderName(Int32) |
Возвращает имя указанного заголовка ответа HTTP. |
| GetLocalAddress() |
Предоставляет доступ к указанному элементу заголовка запроса. |
| GetLocalPort() |
Предоставляет доступ к указанному элементу заголовка запроса. |
| GetPathInfo() |
Возвращает дополнительные сведения о пути для ресурса с расширением URL-адреса. То есть для пути /virdir/page.html/tail |
| GetPreloadedEntityBody() |
Возвращает часть текста HTTP-запроса, который уже был прочитан. |
| GetPreloadedEntityBody(Byte[], Int32) |
Возвращает часть текста HTTP-запроса, считываемого в настоящее время с помощью указанных данных буфера и смещения байтов. |
| GetPreloadedEntityBodyLength() |
Возвращает длину части текста HTTP-запроса, считываемой в настоящее время. |
| GetProtocol() |
При переопределении в производном классе возвращает протокол HTTP (HTTP или HTTPS). |
| GetQueryString() |
Возвращает строку запроса, указанную в URL-адресе запроса. |
| GetQueryStringRawBytes() |
При переопределении в производном классе возвращает строку запроса ответа в виде массива байтов. |
| GetRawUrl() |
Возвращает путь URL-адреса, содержащийся в заголовке запроса с добавленной строкой запроса. |
| GetRemoteAddress() |
Предоставляет доступ к указанному элементу заголовка запроса. |
| GetRemoteName() |
При переопределении в производном классе возвращает имя клиентского компьютера. |
| GetRemotePort() |
Предоставляет доступ к указанному элементу заголовка запроса. |
| GetRequestReason() |
При переопределении в производном классе возвращает причину запроса. |
| GetServerName() |
При переопределении в производном классе возвращает имя локального сервера. |
| GetServerVariable(String) |
Возвращает одну переменную сервера из словаря переменных сервера, связанных с запросом. |
| GetStatusDescription(Int32) |
Возвращает строку, описывающую имя указанного кода состояния HTTP. |
| GetTotalEntityBodyLength() |
Возвращает длину всего текста HTTP-запроса. |
| GetType() |
Возвращает Type текущего экземпляра. (Унаследовано от Object) |
| GetUnknownRequestHeader(String) |
Возвращает нестандартное значение заголовка HTTP-запроса. |
| GetUnknownRequestHeaders() |
Получите все нестандартные пары заголовков HTTP-name-value. |
| GetUriPath() |
Возвращает виртуальный путь к запрошенным URI. |
| GetUrlContextID() |
При переопределении в производном классе возвращает идентификатор контекста текущего соединения. |
| GetUserToken() |
При переопределении в производном классе возвращает маркер олицетворения клиента. |
| GetVirtualPathToken() |
Возвращает маркер олицетворения для виртуального пути запроса. |
| HasEntityBody() |
Возвращает значение, указывающее, содержит ли запрос данные тела. |
| HeadersSent() |
Возвращает значение, указывающее, были ли заголовки ответа HTTP отправлены клиенту для текущего запроса. |
| IsClientConnected() |
Возвращает значение, указывающее, активен ли подключение клиента. |
| IsEntireEntityBodyIsPreloaded() |
Возвращает значение, указывающее, доступны ли все данные запроса и не требуются ли дальнейшие операции чтения от клиента. |
| IsSecure() |
Возвращает значение, указывающее, используется ли подключение SSL. |
| MapPath(String) |
Возвращает физический путь, соответствующий указанному виртуальному пути. |
| MemberwiseClone() |
Создает неглубокую копию текущей Object. (Унаследовано от Object) |
| ReadEntityBody(Byte[], Int32, Int32) |
Считывает данные запроса от клиента (если они не загружены) с помощью указанного буфера для чтения, смещения байтов и максимального количества байтов. |
| ReadEntityBody(Byte[], Int32) |
Считывает данные запроса от клиента (если не предварительно загружено). |
| SendCalculatedContentLength(Int32) |
|
| SendCalculatedContentLength(Int64) |
|
| SendKnownResponseHeader(Int32, String) |
Добавляет стандартный заголовок HTTP в ответ. |
| SendResponseFromFile(IntPtr, Int64, Int64) |
Добавляет содержимое указанного файла в ответ и указывает начальную позицию в файле и количество байтов для отправки. |
| SendResponseFromFile(String, Int64, Int64) |
Добавляет содержимое указанного файла в ответ и указывает начальную позицию в файле и количество байтов для отправки. |
| SendResponseFromMemory(Byte[], Int32) |
Добавляет указанное число байтов из массива байтов в ответ. |
| SendResponseFromMemory(IntPtr, Int32) |
Добавляет указанное количество байтов из блока памяти в ответ. |
| SendStatus(Int32, String) |
Указывает код состояния HTTP и описание состояния ответа, например |
| SendUnknownResponseHeader(String, String) |
Добавляет нестандартный заголовок HTTP в ответ. |
| SetEndOfSendNotification(HttpWorkerRequest+EndOfSendNotification, Object) |
Регистрирует необязательное уведомление при отправке всех данных ответа. |
| ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |