Урок 9. Объект HttpResponse

Встроенный объект HttpResponse выполняет пересылку информации браузеру удаленного пользователя. Разработчик также может обращаться к этому объекту посредством свойства Response объекта Page. Примеры использования этого встроенного объекта мы увидим в последующих разделах. В этом разделе мы рассмотрим основные свойства и методы данного объекта. Начнем со свойств.

Buffer. Свойство логического типа, в котором указывается, будет ли буферизоваться информация, передаваемая удаленному пользователю, перед отправкой. Если разработчик использует значение True, то информация не будет передаваться в браузер после выполнения каждого метода write, а станет накапливаться в буфере, а затем отправляться удаленному пользователю единым пакетом. Данное свойство унаследовано из предыдущих версий ASP.

BufferOutput. Данное свойство является полным функциональным аналогом предыдущего свойства. Однако для приложений ASP.NET рекомендуется использовать именно его.
Cache. В этом свойстве хранятся установки кэширования страницы, такие как, например, срок ее актуальности.
Cachecontroi. Свойство устанавливает значение одноименного HTTP-заголовка. В качестве значения могут использоваться ключевые словаPublic или Private.
charset. В данном свойстве указывается наименование кодировки символов, которая должна быть использована браузером для отображения посланной ему информации.
ContentEncoding. В данном свойстве хранится значение одноименного HTTP-заголовка, который устанавливает тип кодирования пересылаемой информации.
ContentType. Свойство предназначено для хранения MIME-типа передаваемой информации.
cookies. В свойстве хранится коллекция cookies, которая будет установлена на локальную систему пользователя. Более подробно о применении cookies будет рассказано несколько позже в соответствующем разделе главы.
Expires. В данном свойстве указывается срок актуальности передаваемой Web-страницы, попросту, время ее хранения в кэше браузера удаленного пользователя. Значение данного свойства указывается в минутах. Свойство введено в ASP.NET в целях обеспечения совместимости с предыдущими версиями ASP.
ExpiresAbsoiute. Данное свойство, как и предыдущее, устанавливает срок хранения страницы в кэше браузера пользователя. Однако для этого свойства значение указывается в виде стандартной даты, после наступления которой страница будет считаться неактуальной.
Filter. Свойство позволяет разработчику создавать некий фильтр (например, переводящий все символы в верхний регистр), через который будет пропускаться все содержимое отсылаемой Web-страницы перед тем как браузер удаленного пользователя получит эту страницу.
isciientconnected. Свойство логического типа, показывающее, не отключился ли еще удаленный пользователь от сервера.
Output. Ключевое свойство объекта HttpResponse. В нем хранится передаваемая удаленному пользователю информация в виде текста.
Outputstream. Данное свойство весьма похоже на предыдущее свойство Output, однако в нем информация, отсылаемая пользователю, хранится в двоичном виде, а не как текст.
status. Текст, указываемый разработчиком в этом свойстве, будет отображен в строке статуса браузера удаленного пользователя, когда тот получит переданную ему страницу.
statuscode. В данном свойстве хранится код статуса HTTP, передаваемый пользователю. В качестве значения используется целое число, как раз и являющееся кодом статуса передачи информации. По умолчанию используется значение равное 200, обозначающее успешную передачу данных.
statusDescription. Свойство похоже на предыдущее, но есть, конечно, и отличия. Так, значение имеет тип string, т. е. статус передачи информации записывается в виде строки. По умолчанию используется значение ок . Конечно же, помимо свойств, данный встроенный объект обладает и методами. Рассмотрим и их.
AddHeader. Метод позволяет пересылать заголовки протокола HTTP удаленному пользователю. В качестве параметров данного метода передаются наименование заголовка и значение, приписываемое этому заголовку. Оба параметра передаются как тип string. На самом деле этот метод унаследован из предыдущих версий ASP и не рекомендован к употреблению в приложениях ASP.NET.
AppendHeader. Метод полностью идентичен предыдущему. Рекомендован к применению в приложениях ASP.NET. Кстати, всегда следует помнить, что заголовки HTTP добавляются не в стандартный поток, а в самое начало передаваемого документа. В связи с этим лучше при передаче заголовков протокола HTTP использовать буферизацию информации.
AppendToLog. Метод позволяет записывать информацию напрямую в log-файл сервера IIS. Естественно, в качестве параметра передается строка, которую следует записывать в log-файл. Подобный метод позволяет дополнительно документировать действия пользователей.
BinaryWrite. Метод записывает данные в выходной поток, который переправляется удаленному пользователю. Данные передаются в двоичном виде, "как есть". В качестве параметра методу передается массив с элементами типа Byte.
clear. Метод полностью очищает буфер, в котором хранится информация, предназначенная для отправки удаленному пользователю.
ciearContent. Метод полностью функционально идентичен только что рассмотренному методу clear.
ciearHeaders. Метод удаляет все заголовки протокола HTTP, которые находятся в буфере, подготавливаемому к передаче удаленному пользователю.
End. Метод немедленно закрывает установленное соединение с удаленным пользователем. При этом, естественно, никакой информации пользователю не передается.
Flush. Метод немедленно отправляет пользователю всю информацию, накопленную к моменту выполнения метода в буфере. Естественно, для этого свойство BufferOutput должно быть установлено в True, иначе произойдет ошибка, и будет сгенерировано исключение.
Redirect. Метод перенаправляет пользователя к другому ресурсу. Проще говоря, если необходимо вывести отдельную Web-страницу, которая уже сформирована и ее URL известен, следует воспользоваться этим методом. В качестве параметра методу передается URL ресурса, который будет отправлен удаленному пользователю.
Write. Один из наиболее часто используемых методов объекта HttpResponse. Записывает в выводимый поток текстовую информацию. В качестве параметра методу могут передаваться значения типа char, String или м а ссивы тип а Char .
writeFiie. Метод записывает в выводимый поток содержимое файла, имя которого передается методу в качестве параметра типа string. В качестве дополнительных параметров можно передать начальную и конечную позиции передаваемого блока информации.

На этом мы заканчиваем краткий обзор встроенного объекта HttpResponse, позволяющего передавать информацию удаленному пользователю, которая затем будет отображена его браузером.