Объект HttpRequest

Объект HttpRequest
Если объект HttpResponse позволяет разработчику с максимальным удобством отправлять информацию
удаленному пользователю, не заботясь о различных мелочах физического уровня, а сосредотачиваясь
именно на логике отсылаемого пакета, то объект HttpRequest помогает разработчику легко разгрести ту
кучу разнородной информации, которая приходит от удаленного пользователя. В этот объект помещается
информация, посылаемая браузером на сервер. В блоке принимаемой информации могут находиться
данные, введенные пользователем в элементы управления форм, URL запрошенного ресурса,
содержание cookies и многое другое. Объект HttpRequest поможет разработчику получить именно ту
информацию, которая ему нужна для функционирования приложения.
Мы поступим так же, как и в предыдущем разделе — рассмотрим перечень свойств и методов объекта.
Принципы и основные приемы работы с данным объектом все равно будут объяснены в иных разделах,
посвященных конкретным задачам Web-приложений. Начнем со свойств.

AcceptTypes. Свойство содержит в качестве значения массив строк типа string, в которых
записываются типы MIME, которые поддерживаются браузером удаленного пользователя.

AppiicationPath. Свойство содержит путь к виртуальному каталогу, в котором находится ASP.NET
приложение, относительно корневого каталога WWW-сервера.

Browser. Составное свойство, в котором указывается список параметров браузера удаленного
пользователя. Значение данного свойства имеет тип HttpBrowserCapabalities. Соответственно,
объект подобного типа имеет свои свойства, которые необходимо перечислить.

Activexcontrois. Свойство логического типа, указывающее, разрешено ли данному браузеру
работать с элементами ActiveX.

aol. Свойство логического типа, указывающее, использует ли удаленный пользователь
специализированный браузер службы AOL.

Backgroundsounds. Свойство логического типа, указывающее, разрешено ли данному браузеру
воспроизводить звуковые файлы, прикрепленные к Web-страницам. 76

Beta. Свойство логического типа, сигнализирующее, что браузер удаленного пользователя
является всего лишь бета-версией с возможно усеченной функциональностью.

Browser. Значение данного свойства является строкой, в которой содержится условное
наименование браузера. Это же наименование передается в виде содержимого заголовка HTTP с
наименованием User-Agent.

cdf. Свойство логического типа, указывающее, может ли браузер удаленного пользователя
обрабатывать push-каналы доставки информации, созданные на основе формата CDF (Channel
Definition Format).

Cookies. Свойство логического типа, указывающее, разрешено ли браузеру сохранять cookies на
машине удаленного клиента.

crawler. Свойство логического типа, указывающее, установлено ли в браузере пользователя
средство поиска Web crawler.

Frame ss Свойство указывает, может ли браузер пользователя отображать фреймы. В настоящее
время этот вопрос, очевидно, не имеет особого смысла.

JavaApplets. Свойство логического типа, указывающее, может ли браузер удаленного
пользователя корректно работать с апплетами Java.

JavaScript. Логическое свойство, в котором указывается, умеет или нет браузер удаленного
пользователя интерпретировать и выполнять Java-сценарии.

MajorVersion. Свойство содержит основной номер версии браузера, т. е. число, стоящее до точки
в полном номере версии. Значение данного свойства имеет, естественно, тип integer.

MinorVersion. Свойство указывает дополнительный номер версии, т. е. число, находящееся после
первой точки в полном номере версии.

MsoomVersion. В свойстве указывается номер версии объектной модели документа (Microsoft
XML Document Object Model), которая поддерживается браузером пользователя.

Platform. В данном свойстве содержится кодовое наименование операционной системы, которая
установлена на машине удаленного пользователя. Естественно, значение данного свойства
имеет типString.

Tables. Свойство указывает, может ли браузер пользователя отображать таблицы, включаемые в
состав HTML-документов. Да, было когда-то такое время, когда браузеры не могли работать с
таблицами.

Туре. В данном свойстве указываются кодовое наименование браузера и основной номер его
версии. Значение свойства имеет тип string.

VBScript. Логическое свойство, в котором указывается, умеет или нет браузер удаленного
пользователя интерпретировать и выполнять сценарии, написанные на языке VBScript.

version. Свойство содержит в строковом виде полную версию применяемого пользователем
браузера.

wscDOMVersion. В свойстве указывается номер версии объектной модели документа (W3C
Document Object Model), которая разработана консорциумом WWW.


winie. Логическое свойство, в котором указывается, работает удаленный пользователь на
шестнадцатиразрядной версии Windows или нет.
Win32. Логическое свойство, в котором указывается, работает удаленный пользователь на
тридцатидвухразрядной версии Windows или нет.

clientcertificate. Значение данного свойства имеет тип HttpCiientCertificate и содержит
информацию об установках безопасности клиента, если тот использует соединение по протоколу
SSL 3.0.

contentEncoding. В этом свойстве указывается наименование кодировки символов, примененной
браузером при отправке информации на сервер.

contentLength. В данном свойстве указывается размер блока информации, переданного на
сервер. Размер рассчитывается в байтах. Естественно, значение свойства имеет тип integer.

contentType. Свойство содержит наименование MIME-типа для принимаемой сервером
информации.

Cookies. Свойство содержит коллекцию cookies, которые передаются на сервер браузером
пользователя.

Filepath. В свойстве содержится путь к документу, который запросил пользователь. При этом не
учитывается путь для перемещения внутри запрошенного документа, т. е. все закладки, если
таковые были указаны в URL, этим свойством игнорируются. Путь указывается только к файлу.

Files. Свойство содержит коллекцию файлов, переданных пользователем на сервер. Естественно,
свойство имеет смысл обрабатывать только в том случае, если указан MIME-ТИП multipart /formdata.

Filter. Данное сюйстю является функционально идентичным своему одноименному близнецу,
который применяется к объекту HttpResponse. В этом свойстве указывается фильтр,
применяемый к входящему потоку информации.

Form. В свойстве содержится коллекция наименований органов управления формы, которая
была использована посетителем сайта для ввода информации.

Headers. В свойстве содержится коллекция заголовков протокола HTTP, переданных браузером
удаленного пользователя на сервер.

HttpMethod. Свойство указывает, какой именно тип передачи информации на сервер был
использован браузером удаленного пользователя. В качестве значений применяются ключевые
слова Get, Post и Head. Тип значения свойства, естественно, string.

inputstream. В свойстве содержится входящий поток информации в "сыром" виде. А именно
таким, каким его принял сервер.

isAuthenticated. Логическое свойство, указывающее, прошел ли удаленный пользователь
аутентификацию или нет.

issecureconnection. Логическое свойство, которое применяется для указания, что клиент
пользуется защищенным протоколом соединения, таким, как SSL.

Pa rams. Свойство объединяет в себе коллекцию всех переменных изQueryString, Form,
ServerVariables и Cookies.

Path. В свойстве указывается путь в системе виртуальных каталогов к запрошенному удаленным
пользователем ресурсу.

Pathinfo. Свойство содержит часть URL, запрошенного пользователем, располагающуюся после
расширения файла. Другими словами, это добавочная информация, включенная в состав URL,
помимо основного документа.

PhysicaiAppiicationpath. В свойстве содержится физический (а не виртуальный) путь к каталогу,
в котором находится и выполняется действующее приложение ASP.NET.

PhysicaiPath. Свойство содержит физический путь, соответствующий виртуальному
расположению файла, запрошенного пользователем.

QueryString. В свойстве находится коллекция с наименованиями всех переменных и параметров,
переданных в строке запроса URL. Обычно в эту строку добавляются наименования органов
ввода информации из форм и значений, введенных в них пользователем, если применен метод
передачи get.

RawUri. В свойстве находится URL, запрошенный пользователем, в сыром виде, не прошедшим
процедуру лексического анализа для выделения из него составных частей. Если у разработчика
есть такое желание, он может самостоятельно разбирать этот URL.

RequestType. Свойство позволяет получать или устанавливать тип передачи информации от
браузера удаленного пользователя на сервер. В качестве значений, естественно, могут быть
использованы слова get и post.

ServerVariables. Свойство позволяет приложению получить доступ к коллекции наименований
стандартных свойств сервера и браузера.

TotaiBytes. В свойстве указывается размер пришедшего на сервер запроса от удаленного
пользователя в байтах. Естественно, значение данного свойства имеет тип integer.

uri. В данном составном свойстве собрана самая различная информация об URL, запрошенном
пользователем.

uriReferrer. В данном свойстве содержится информация об URL той страницы, с которой
пользователь пришел на текущую.

userAgent. Свойство содержит неразобранную информацию о браузере, применяемом
удаленным пользователем, в виде одной строки.

userHostAddress. В свойстве содержится IP-адрес удаленного пользователя, который послал
данный запрос.


userHostName. В свойстве содержится доменное имя, приписанное удаленному пользователю.
userLanguages. Значение содержит отсортированный массив строк, в которых указываются
языки, используемые удаленным пользователем, т. е. его лингвистические предпочтения.
На этом список свойств встроенного объекта HttpRequest заканчивается. Мы переходим к его
уникальным методам.

BinaryRead. Метод позволяет читать определенное количество байтов из входящего потока
информации. В качестве параметра методу передается целочисленное значение, указывающее,
сколько именно байтов следует прочитать. Метод возвращает массив типа Byte.

MapimageCoordinates. Метод возвращает двумерный массив, содержащий координаты активных
областей, присущих изображению-гиперссылке.

saveAs. Метод сохраняет входящий поток информации на диск в виде файла. В качестве
параметров методу передаются строка с наименованием создаваемого файла и логическое
значение, указывающее, следует ли сохранять помимо основного потока информации еще и
заголовки протокола HTTP, пришедшие вместе с ним.
Список уникальных методов объекта HttpRequest исчерпан. Настало время перейти к рассмотрению
других встроенных объектов.