Объект HttpResponse
Объект HttpResponse
Встроенный объект HttpResponse выполняет пересылку информации браузеру удаленного пользователя. Разработчик также может обращаться к этому объекту посредством свойства Response объекта Page. Рассмотрим основные свойства и методы данного объекта.
Свойства:
Buffer. Свойства логического типа, в котором указывается, будет ли буферизоваться информация, передаваемая удаленному пользователю, перед отправкой. Если разработчик используется значение True, то информация не будет передаваться в браузер после выполнения каждого метода Write, а станет накапливаться в буфере, а затем отправляться удаленному пользователю единым пакетом. Данное свойство унаследовано из предыдущих версий ASP.
BufferOutput. Данное свойство является полным функциональным аналогом предыдущего свойства. Однако для приложений ASP.NET рекомендуется использовать именно его.
Cache. В этом свойстве хранятся установки кэширования страниц , такие как, например, срок ее актуальности.
CacheControl. Свойство устанавливает значение одноименного HTTP-заголовка. В качестве значения могут использоваться ключевые слова Public или Private.
Charset. В данном свойстве указывается наименование кодировки символов, которая должна быть использована браузером для отображения посланной ему информации.
ContentEncoding. В данном свойстве храниться значение одноименного HTTP-заголовка, который устанавливает тип кодирования пересылаемой информации.
ContentType. Свойство предназначено для хранения MIME-типа передаваемой информации.
Cookies. В свойстве хранится коллекция cookies, которая будет установлена на локальную систему пользователя.
Expires. В данном свойстве указывается срок актуальности передаваемой Web-страницы, попросту, время ее хранения в кеш браузера удаленного пользователя. Значение данного свойства указывается в минутах. Свойство введено в ASP.NET в целях обеспечения совместимости с предыдущими версиями ASP.
ExpiresAbsolute. Данное свойство, как и предыдущее, устанавливает срок хранения страницы в кеше браузера пользователя. Однако для этого свойства значения указывается в виде стандартной даты, после наступления, которой страница будет считаться не актуальной.
Filter. Свойство позволяет разработчику создавать некий фильтр (например, переводящий все символы в верхний регистр), через который будет пропускать все содержимое отсылаемой Web-страницы, перед тем как браузер удаленного пользователя получит эту страницу.
IsClientConnected. Свойство логического типа, показывающее, не отключился ли еще удаленный пользователь от сервера.
Output. Ключевое слово объекта HttpResponse. В нем хранится передаваемая пользователю информация в виде текста.
OutputStream. Данное свойство весьма похоже на предыдущее, однако в нем информация, отсылаемая пользователю, хранится в двоичном коде, а не как текст.
Status. Текст, указываемый разработчиком в этом свойстве, будет отображен в строке статуса браузера удаленного пользователя, когда тот получит переданную ему страницу.
StatusCode. В данном свойстве хранится код статуса HTTP, передаваемый пользователю. В качестве значения используется целое число, как раз и являющееся кодом статуса передачи информации. По умолчанию используется значение равное 200, обозначающее успешную передачу данных.
StatusDescription. Свойство похоже на предыдущее, но есть, конечно, и отличия. Так, значение имеет тип String, т.е. статус передачи информации записывается в виде строки. По умолчанию используется значение OK.
Конечно же, помимо свойств, данный встроенный объект обладает и методами, рассмотрим их:
AddHeader. Метод позволяет пересылать заголовки протокола HTTP удаленному пользователю. В качестве параметров данного метода передаются наименование заголовка и значение, приписываемое этому заголовку. Оба параметра передаются как тип String. На самом деле этот метод унаследован из предыдущих версий ASP и не рекомендован к употреблению в приложениях ASP.NET
AppendHeader. Метод полностью идентичен предыдущему. Рекомендован к применению в приложению ASP.NET. Кстати, всегда следует помнить, что заголовки HTTP добавляются не в стандартный поток, а в самое начало передаваемого документа. В связи с этим лучше при передаче заголовков протокола HTTP использовать буферизацию информации.
AppendToLog. Метод позволяет записывать информацию напрямую в log-файл сервера IIS. Естественно, в качестве параметра передается строка, которую следует записать в log-файл. Подобный метод позволяет дополнительно документировать действия пользователей.
BinaryWrite. Метод записывает данные в выходной поток, который переправляется удаленному пользователю. Данные передаются в двоичном виде, "как есть". В качестве параметру методу передается массив с элементами типа Byte.
Clear. Метод полностью очищает буфер, в котором хранится информация, предназначенная для отправки удаленному пользователю.
ClearContent. Метод полностью функционально идентичен только что рассмотренному методу Clear.
ClearHeaders. Метод удаляет все заголовки протокола HTTP, которые находятся в буфере, подготавливаемому к передаче удаленному пользователю.
End. Метод немедленно закрывает установленное соединение с удаленным пользователем. При этом, естественно, никакой информации пользователю не передается.
Flush. Метод немедленно отправляет пользователю всю информацию, накопленную к моменту выполнению метода в буфере. Естественно, для этого свойство BufferOutput должно быть установлено в True, иначе произойдет ошибка, и будет сгенерировано исключение.
Redirect. Метод перенаправляет пользователя к другому ресурсу. Проще говоря, если необходимо вывести отдельную Web-страницу, которая уже сформирована и ее URL известен, следует воспользоваться этим методом. В качестве параметра методу передается URL ресурса, который будет отправлен удаленному пользователю.
Write. Один из наиболее часто используемых методов объекта HttpResponse. Записывает в выводимый поток текстовую информацию. В качестве параметра методу могут передаваться значению типа Char, String или массивы типа Char.
WriteFile. Метод записывает в выводимый поток содержимое файла, имя которого передается методу в качестве параметра типа String. В качестве дополнительных параметров можно передать начальную и конечную позиции передаваемого блока информации.
На этом заканчивается краткий обзор встроенного объекта HttpResponse, позволяющего передавать информацию удаленному пользователю, которая затем будет отображена его браузером.