HttpRequestBase Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Служит базовым классом для классов, которые позволяют ASP.NET считывать значения HTTP, отправленные клиентом во время веб-запроса.
public ref class HttpRequestBase abstract
public abstract class HttpRequestBase
type HttpRequestBase = class
Public MustInherit Class HttpRequestBase
- Наследование
-
HttpRequestBase
- Производный
Комментарии
Класс HttpRequestBase является абстрактным классом, который содержит те же члены, что HttpRequest и класс. Класс HttpRequestBase позволяет создавать производные классы, такие как класс HttpRequest, но можно настроить и работать вне конвейера ASP.NET. При выполнении модульного тестирования обычно используется производный класс для реализации элементов с настраиваемым поведением, выполняющим тестовый сценарий.
Класс HttpRequestWrapper наследуется от класса HttpRequestBase. Класс HttpRequestWrapper служит оболочкой для HttpRequest класса. Во время выполнения экземпляр класса обычно используется HttpRequestWrapper для вызова членов HttpRequest объекта.
Конструкторы
| Имя | Описание |
|---|---|
| HttpRequestBase() |
Инициализирует класс для использования наследуемым экземпляром класса. Этот конструктор может вызываться только унаследованным классом. |
Свойства
| Имя | Описание |
|---|---|
| AcceptTypes |
При переопределении в производном классе получает массив поддерживаемых клиентом типов MIME. |
| AnonymousID |
При переопределении в производном классе получает анонимный идентификатор пользователя, если он доступен. |
| ApplicationPath |
При переопределении в производном классе получает виртуальный корневой путь приложения ASP.NET на сервере. |
| AppRelativeCurrentExecutionFilePath |
При переопределении в производном классе получает виртуальный путь корня приложения и делает его относительным с помощью нотации tilde (~) для корневого каталога приложения (как в "~/page.aspx"). |
| Browser |
При переопределении в производном классе получает сведения о возможностях браузера запрашивающего клиента. |
| ClientCertificate |
При переопределении в производном классе получает сертификат безопасности клиента текущего запроса. |
| ContentEncoding |
При переопределении в производном классе получает или задает набор символов данных, предоставляемых клиентом. |
| ContentLength |
При переопределении в производном классе получает длину в байтах содержимого, отправленного клиентом. |
| ContentType |
При переопределении в производном классе получает или задает тип контента MIME запроса. |
| Cookies |
При переопределении в производном классе получает коллекцию файлов cookie, отправленных клиентом. |
| CurrentExecutionFilePath |
При переопределении в производном классе получает виртуальный путь текущего запроса. |
| CurrentExecutionFilePathExtension |
При реализации в производном классе получает расширение имени файла, указанного в свойстве CurrentExecutionFilePath . |
| FilePath |
При переопределении в производном классе получает виртуальный путь текущего запроса. |
| Files |
При переопределении в производном классе получает коллекцию файлов, отправленных клиентом, в многопартийном формате MIME. |
| Filter |
При переопределении в производном классе получает или задает фильтр, используемый при чтении текущего входного потока. |
| Form |
При переопределении в производном классе получает коллекцию переменных формы, отправленных клиентом. |
| Headers |
При переопределении в производном классе получает коллекцию заголовков HTTP, отправленных клиентом. |
| HttpChannelBinding |
При переопределении в производном классе получает ChannelBinding объект текущего HttpWorkerRequest экземпляра. |
| HttpMethod |
При переопределении в производном классе получает метод передачи данных HTTP (например |
| InputStream |
При переопределении в производном классе получает содержимое входящего текста сущности HTTP. |
| IsAuthenticated |
При переопределении в производном классе получает значение, указывающее, прошел ли запрос проверку подлинности. |
| IsLocal |
При переопределении в производном классе получает значение, указывающее, находится ли запрос с локального компьютера. |
| IsSecureConnection |
При переопределении в производном классе получает значение, указывающее, использует ли HTTP-подключение безопасные сокеты (протокол HTTPS). |
| Item[String] |
При переопределении в производном классе получает указанный объект из Cookiesколлекций Formили QueryStringServerVariables коллекций. |
| LogonUserIdentity |
При переопределении в производном классе получает WindowsIdentity тип текущего пользователя. |
| Params |
При переопределении в производном классе получает объединенную коллекцию QueryString, FormServerVariablesи Cookies элементы. |
| Path |
При переопределении в производном классе получает виртуальный путь текущего запроса. |
| PathInfo |
При переопределении в производном классе получает дополнительные сведения о пути для ресурса с расширением URL-адреса. |
| PhysicalApplicationPath |
При переопределении в производном классе получает физический путь к файловой системе корневого каталога текущего приложения. |
| PhysicalPath |
При переопределении в производном классе получает физический путь к файловой системе запрошенного ресурса. |
| QueryString |
При переопределении в производном классе получает коллекцию переменных строки HTTP-запроса. |
| RawUrl |
При переопределении в производном классе получает полный URL-адрес текущего запроса. |
| ReadEntityBodyMode |
При реализации в производном классе получает значение, указывающее, считывается ли текст сущности запроса, а если да, то как он был считывается. |
| RequestContext |
При переопределении в производном классе получает RequestContext экземпляр текущего запроса. |
| RequestType |
При переопределении в производном классе получает или задает метод передачи данных HTTP ( |
| ServerVariables |
При переопределении в производном классе получает коллекцию переменных веб-сервера. |
| TimedOutToken |
При реализации в производном классе получает объект, споткнутый CancellationToken при истечении времени ожидания запроса. |
| TlsTokenBindingInfo |
Возвращает или задает сведения о привязке маркера для этого экземпляра. |
| TotalBytes |
При переопределении в производном классе получает количество байтов в текущем входном потоке. |
| Unvalidated |
При реализации в производном классе предоставляет доступ к значениям HTTP-запроса без активации проверки запроса. |
| Url |
При переопределении в производном классе получает сведения о URL-адресе текущего запроса. |
| UrlReferrer |
При переопределении в производном классе получает сведения о URL-адресе запроса клиента, связанного с текущим URL-адресом. |
| UserAgent |
При переопределении в производном классе получает полную строку агента пользователя клиента. |
| UserHostAddress |
При переопределении в производном классе получает IP-адрес узла клиента. |
| UserHostName |
При переопределении в производном классе получает DNS-имя клиента. |
| UserLanguages |
При переопределении в производном классе получает отсортированный массив параметров языка клиента. |
Методы
| Имя | Описание |
|---|---|
| Abort() |
Принудительно завершает базовое TCP-подключение, что приводит к сбою любого выдающегося ввода-вывода. |
| BinaryRead(Int32) |
При переопределении в производном классе выполняет двоичное чтение указанного числа байтов из текущего входного потока. |
| Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
| GetBufferedInputStream() |
При реализации в производном классе получает Stream объект, который можно использовать для чтения входящего текста сущности HTTP. |
| GetBufferlessInputStream() |
При реализации в производном классе получает Stream объект, который можно использовать для чтения входящего текста сущности HTTP, при необходимости отключая ограничение длины запроса, заданное в свойстве MaxRequestLength . |
| GetBufferlessInputStream(Boolean) |
При реализации в производном классе получает Stream объект, который можно использовать для чтения входящего текста сущности HTTP, при необходимости отключая ограничение длины запроса, заданное в свойстве MaxRequestLength . |
| GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
| GetType() |
Возвращает Type текущего экземпляра. (Унаследовано от Object) |
| InsertEntityBody() |
При реализации в производном классе предоставляет копию текста сущности HTTP-запроса в IIS. |
| InsertEntityBody(Byte[], Int32, Int32) |
При реализации в производном классе служба IIS предоставляет копию текста сущности HTTP-запроса и сведения об объекте сущности запроса. |
| MapImageCoordinates(String) |
При переопределении в производном классе сопоставляет входящий параметр формы поля изображения с соответствующими значениями x-координат и координат y. |
| MapPath(String, String, Boolean) |
При переопределении в производном классе сопоставляет указанный виртуальный путь с физическим путем на сервере. |
| MapPath(String) |
При переопределении в производном классе сопоставляет указанный виртуальный путь с физическим путем на сервере. |
| MapRawImageCoordinates(String) |
Сопоставляет параметр формы поля входящего изображения с соответствующими значениями координат x и y. |
| MemberwiseClone() |
Создает неглубокую копию текущей Object. (Унаследовано от Object) |
| SaveAs(String, Boolean) |
При переопределении в производном классе сохраняет HTTP-запрос на диск. |
| ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |
| ValidateInput() |
При переопределении в производном классе вызывает проверку для коллекций, к которым осуществляется доступ через Cookiesсвойства Formи QueryString свойства. |