Глава 3 Приложения ASP

Элементы выпадающего списка задаются при помощи органов управления, объединенных в группу Options for SELECT tag (Элементы выпадающего списка). Каждому элементу списка соответствует некое значение, которое будет передано обрабатывающей программе на Web-сервер, когда пользователь завершит ввод данных. Текст элемента списка указывается в поле ввода Text (Текст), а соответствующее ему значение — в поле Value (Значение). Затем введенная пара "имя-значение" вносится в состав списка при помощи кнопки Insert (Вставить). Порядок отображения элементов регулируется при помощи двух кнопок с изображением стрелок, направленных вверх и вниз. Эти кнопки перемещают соответственно вверх и вниз по списку выделенный элемент. Удаление какого-либо элемента из списка осуществляется, как нетрудно догадаться, при помощи кнопки Delete (Удалить). Наименование самого выпадающего списка, которое будет передано в обрабатывающую программу на сервере, задается в поле текстового ввода Name (Имя). Количество строк, отображаемых браузером при нажатии на кнопку, раскрывающую список, указывается в поле Size (Размер). Правда, в этом случае выпадающий список может потерять свою привычную форму и превратиться в обычный список с полосами прокрутки. Подобный список также может создаваться при помощи компонента Listbox. А в том случае, если разработчик готов предоставить пользователю возможность выбора не одного, а нескольких элементов выпадающего списка сразу, следует установить флажок в независимом переключателе Allow multiple selections (Разрешить множественный выбор).

При использовании диалогового окна настройки свойств выпадающего списка может создаться впечатление, что обычное штатное окно свойств Properties (Свойства) уже не может предоставить каких-либо новых возможностей. Однако это не так. В нем присутствует свойство seiectedindex, которое указывает номер элемента, выбранного по умолчанию. Кстати, когда пользователь выберет свой элемент из выпадающего списка, соответствующим образом изменится и значение этого свойства.

Таблицы являлись одним из самых часто используемых инструментов в дизайне Web-страниц. Дело в том, что именно эти компоненты могли создать некое подобие верстки. Теперь, если мы используем абсолютное позиционирование элементов Web-страниц, нет нужды использовать хитрые приемы верстки при помощи таблиц. Однако далеко не факт, что разработчик всегда будет иметь возможность использовать абсолютное позиционирование, поэтому забывать о таблицах не стоит.

Вставка таблицы на проектируемую Web-страницу производится либо при помощи компонента Table, либо при помощи команды Table | Insert | Table (Таблица | Вставить | Таблица). По умолчанию создается таблица из трех строк и трех колонок. Однако всегда есть возможность настроить внешний вид настолько тонко, насколько это позволяет технология HTML. Естественно, все параметры отображения таблицы задаются при помощи ее свойств, которые нам предстоит рассмотреть.

• align. Свойство устанавливает горизонтальное выравнивание содержимого ячеек таблицы. В качестве значения свойства разработчик может использовать одно из трех ключевых слов: left, center и right, которые прижимают содержимое ячеек к левому краю ячеек, центрируют его или прижимают к правому краю, соответственно.
• background. В качестве значения данного свойства используется URL графического файла, который будет использован в качестве фона таблицы.
• bgcolor. Свойство задает цвет фона таблицы. Естественно, не имеет смысла использовать это свойство одновременно с предыдущим.
• bprdercoior. Свойство задает цвет границ ячеек и таблицы в целом.
• bordercoiordark. Свойство используется для создания иллюзии трехмерной границы таблицы. Для этого граница таблицы разделяется на две части. Верхняя левая половина отображается светлым цветом, а нижняя правая — темным. При этом подобное разделение относится и к ячейкам. Но у ячеек темная и нижняя границы меняются местами. Данное свойство устанавливает цвет темной половины границы. Впрочем, разработчик может сделать эту границу светлой. Выбор цвета полностью в его власти.
• bordercoioriight. Свойство устанавливает цвет светлой стороны границы.
• ceiipadding. Свойство задает отбивку ячейки, т. е. расстояние между содержимым ячейки и ее границами. В качестве значения свойства используется целое число, обозначающее количество пикселов.
• cellspacing. Свойство предназначено для установки отступа ячеек, т. е. расстояния между самими ячейками.
• height. Свойство задает высоту таблицы. На самом деле, изначально высота таблицы рассчитывается на основе ее содержимого, как сумма высот всех столбцов. А высота каждого столбца есть высота его самой высокой ячейки. Однако разработчик при помощи данного свойства может сам установить высоту таблицы. Если это значение будет больше, чем высота таблицы, рассчитанная браузером на основе ее содержимого, то будет использоваться значение, установленное разработчиком.
• width. Свойство задает ширину таблицы. Как и в случае с высотой, это свойство имеет вес только тогда, когда превышает ширину, рассчитанную на основе содержимого ячеек. При этом в отличие от высоты таблицы, которую разработчик может задавать лишь в пикселах, ширина может указываться как в пикселах, так и в процентах.

На самом деле необязательно устанавливать все свойства таблицы в окне Properties (Свойства). Если щелкнуть по выделенной таблице правой кнопкой мыши, и в появившемся контекстном меню выполнить команду Properties (Свойства), то будет активизировано диалоговое окно Property Pages (Свойства Таблицы), показанное на рис. 3.8. В этом окне можно установить все параметры отображения, что называется, в визуальном режиме.

Все параметры отображения, установленные для таблицы, распространяются на ее отдельные строки и ячейки. Однако если разработчик установит другие параметры для каких-либо ячеек или строк, то вновь установленные свойства перекроют более общие свойства таблицы. Другими словами, свойства для более низких объектов в табличной иерархии имеют несколько больший вес.

Рис. З.8. Диалоговое окно

Property Pages

Однако только на уровне ячеек таблиц можно задать некоторые дополнительные свойства отображения их содержимого. Для этого следует перевести курсор именно в ту ячейку, свойства которой необходимо установить, и перейти к встроенному окну редактирования свойств объекта Properties (Свойства). Естественно, мы рассмотрим те свойства, которые типичны для ячеек, и доступ к которым на уровне всей таблицы не предусмотрен.

• coispan. Свойство используется, если одна ячейка будет объединять в себе несколько ячеек из соседних столбцов, но в пределах одной строки. По сути дела, значение этого свойства указывает, сколько бы ячеек было вместо искомой ячейки, если бы она не объединяла столбцы.
• nowrap. Логическое свойство, указывающее, может ли браузер разбивать текстовое содержимое ячейки на несколько строк, если в исходном виде оно превышает горизонтальные размеры ячейки.
• rowspan. Свойство весьма похоже на только что рассмотренное свойство coispan. Но при этом указывается, сколько объединяется ячеек по вертикали.
• vaiign. Свойство регулирует выравнивание содержимого ячеек по вертикали. В качестве значения данного свойства может быть использовано одно из предустановленных ключевых слов: baseline, bottom, middle и top, которые выравнивают содержимое ячейки по базовой линии шрифта, прижимают содержимое к верхней границе ячейки, центрируют по вертикали и прижимают к нижнему краю ячейки соответственно.

Также нам доступны методы объединения соседних элементов Web-страницы в единые блоки. Все элементы оформления HTML-документов разделяются на два типа: inline-элементы, которые чаще всего являются просто элементами текста, и блочные элементы, inline-элементы могут являться частью строки, а блочные элементы всегда занимают обособленное место на Web-странице, и обязаны начинаться всегда с новой строки. Естественно, блочные элементы могут включать в себя другие блочные элементы и inline-элементы. По вполне понятным причинам inline-элементы не могут включать в себя блочные элементы.

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

Для объединения элементов блочного типа используется тег

с его закрывающим близнецом

. А для iniine-элементов используется пара тегов и . Учитывая вышесказанное, ясно, что блок с тегом

не может располагаться внутри блока с тегом , так как блочные элементы не могут входить в состав iniine-элементов.

Visual Studio .NET предоставляет разработчику возможность использовать подобные блочные инструкции. Microsoft, естественно, предпочитает блоки, реализуемые тегом

. Элемент Label опирается именно на этот тег. Однако в элементе Label нельзя группировать иные элементы оформления Web-страницы. Поэтому в палитре компонентов HTML находятся еще два элемента, создающие подобные блоки-контейнеры. И называются они практически одинаково — Flow Layout Panel и Grid Layout Panel. Более того, по набору своих свойств они также идентичны. В чем же разница между ними? Дело в том, что элемент Flow Layout Panel применяется в том случае, когда требуется использовать стандартное расположение элементов без применения абсолютной модели позиционирования. В тех случаях, когда разработчик планирует применять подобную модель позиционирования внутри блока-контейнера, следует использовать компонент Grid Layout Panel. А потом уже внутри этих контейнеров разработчик сможет помещать различные элементы оформления Web-страниц.

Компонент с наименованием image позволяет размещать на разрабатываемых Web-страницах графические изображения и видеоклипы. Естественно, основные параметры данного компонента задаются при помощи все тех же свойств.

• alt. Свойство задает текст, который будет отображаться в виде хинта-подсказки при наведении пользователем курсора мыши на загруженную и отображенную браузером картинку. В том случае, если по каким-либо причинам искомое графическое изображение не будет загружено, например, из-за неверной ссылки на него или установок браузера, данная текстовая строка будет отображена вместо картинки или видеоклипа.
• border. Свойство устанавливает ширину границы, отображаемой вокруг рисунка или области воспроизведения видеоклипа. Значением данного свойства является неотрицательное целое число, указывающее толщину границы в пикселах.
• controls. Свойство логического типа, которое применяется разработчиком в тех случаях, когда на Web-страницу внедряется не простое графическое изображение, а видеоклип. Данное свойство указывает, будут ли вместе с видеоклипом отображаться органы управления его воспроизведением, а именно, кнопки запуска воспроизведения и паузы, а также бегунок, устанавливающий текущую позицию воспроизведения.
• dynsrc. Свойство применяется для внедрения в состав Web-страницы видеоклипов. Значением свойства является URL воспроизводимого видеофайла. Естественно, разработчикам предоставляется возможность вставлять файлы с расширениями .avi, .asf и .mpeg, т. е. именно те типы, с которыми работает Windows Media Player. Хотя на самом деле браузеры могут воспроизводить видеофайлы и других форматов, если в системе ft удаленного пользователя установлены соответствующие видеопроигрыватели.
• loop. Это свойство, как и два предыдущих, используется при работе с видеоклипами. Оно задает количество повторов воспроизведения ви-деоклипа после того, как будет полностью загружен соответствующий видеофайл,
• lows гс. Данное свойство применяется при работе с графическими изображениями. Оно указывает на облегченную версию картинки, которая будет использована браузером в тех случаях, когда скорость работы с интернетом достаточно низка, и придется слишком долго загружать основное изображение. В качестве значения свойства, естественно, используется URL, указывающий на то самое "облегченное" изображение.
• src. Свойство содержит URL, указывающий на графический файл, в котором хранится искомое изображение, предназначенное для отображения на Web-странице.
• usemap. Свойство используется, если данное графическое изображение является одновременно местом для размещения одной или нескольких гиперссылок. В качестве значения свойства используется URL.
• vrmi. Свойство применяется для внедрения на Web-страницу не просто изображения, а сцены виртуальной реальности, созданной при помощи языка VRML (Virtual Reality Modeling Language).
• hspace. Свойство устанавливает размер отступа от границы графического изображения до окружающих его остальных элементов оформления Web-страницы по вертикали. Значением свойства является целое число, указывающее размер отступа в пикселах.
• vspace. Свойство устанавливает размер отступа от границы графического изображения до окружающих его остальных элементов оформления Web-страницы по горизонтали. Значением свойства является целое число, указывающее размер отступа в пикселах.

И последним элементом, который мы еще не рассмотрели на вкладке HTML, является элемент Horizontal Rule, который позволяет размещать на Web-странице горизонтальную линию, являющуюся штатным средством HTML для визуального разделения различных блоков информации. Подобная линия реализуется при помощи тега

---

. Естественно, этот элемент также обладает некоторыми специфичными свойствами.

• align. Указывает горизонтальное позиционирование линии. В качестве значения свойства используется одно из трех ключевых слов — center, left или right, которые центрируют линию, или прижимают ее к левому или правому краю окна просмотра браузера, соответственно.
• color. Свойство задает цвет отображаемой горизонтальной линии.
• noshade. Логическое значение, указывающее, будет ли горизонтальная линия иметь тень, или нет. Если пользователь использует значение False, то вместе с линией будет отображена и ее тень.
• size. Свойство задает толщину отображаемой горизонтальной линии в пикселах.
• width. Задает длину горизонтальной линии. Длина может указываться как в процентах, так и в пикселах.

На этом перечень компонентов вкладки HTML заканчивается. Они чаще всего используются просто для оформления Web-страниц, а все основные действия Web-приложений связаны с компонентами вкладок Web Forms (Web-формы) и Components (Компоненты), которые мы будем рассматривать в следующих разделах этой главы.

Элементы Web Forms

Компоненты, размещенные на вкладке Web Forms (Web-формы), во многом совпадают по наименованиям и внешнему виду с компонентами вкладки HTML. Основное различие между ними заключается в том, что компоненты Web Forms предназначены для работы с сервером, который может изменять их свойства и обрабатывать события, инициируемые этими компонентами. Естественно, достаточно большую часть свойств данные компоненты наследуют от своих обычных предшественников с вкладки HTML. Однако существуют и дополнительные свойства, которые регулируют различные рабочие состояния этих элементов и порядок обработки и передачи информации. Сначала мы просто перечислим компоненты Web Forms (Web-формы) с их кратким описанием, а затем уже перейдем к детальному рассмотрению тех или иных свойств.

• Компонент Label. Полное наименование класса, который реализует данный компонент — system.Web.ui.webControis.Label. Предназначен только для отображения текста.
• Компонент TextBox. Полное наименование его класса — System.web.ui.WebControis.TextBox. Это обычное однострочное поле текстового ввода.
• Компонент Button. Создает кнопку. Полное наименование класса — System.web.ui.WebControis.Button. При работе с компонентами Web Forms (Web-формы) разработчику не нужны специализированные типы кнопок, такие как Reset и Submit, так как реакцию приложения на нажатие подобных кнопок он определяет самостоятельно.
• Компонент LinkButton. Полное наименование класса —System. Web. UI .WebControis. LinkButton. Данный компонент п ри ото бражении его браузером выглядит как обычная гиперссылка, однако функционально он полностью совпадает с компонентом Button.
• Компонент imageButton. Полное наименование класса — system.web.ui.WebControis.imageButton. Выглядит как обычное графическое изображение, однако на деле является кнопкой.
• Компонент HyperLink. Предназначен для создания гиперссылок на разрабатываемой Web-странице. Полное наименование класса —
• System.Web.UI.WebControis.HyperLink.
• Компонент DropDownList. Позволяет пользователю ввести свое текстовое значение или выбрать его из выпадающего текстового списка. Полное наименование класса— System. Web.UI.WebControls. DropDownList.
• Компонент ListBox. Полное наименование класса — System. Web. UI. WebControis. ListBox. Позволяет пользователю выбрать одно или несколько значений из списка.
• Компонент DataGrid. Достаточно объемный и сложный компонент, который позволяет отображать информацию в табличном виде. Полное наименование Класса — System.Web.UI.WebControls.DataGrid.
• Компонент DataList. Предназначен для отображения информации, получаемой из набора данных, обычно из подключенной базы данных. Подобен таблице, но применяет свои методы отображения различных элементов. Полное наименование класса —Systern.Web.UI.WebControis.DataList.
• Компонент Repeater. Предназначен для отображения повторяющихся элементов оформления Web-страницы. Установка параметров отображения производится при помощи тегов HTML, т. е. визуальных средств установки параметров отображения у данного компонента нет. Полное наименование класса — System.Web.UI.WebControls.Repeater.
• Компонент checkBox. Создает единичный независимый переключатель. В отличие от своего предшественника с палитры HTML, данный компонент содержит помимо самого переключателя еще и текст, идентифицирующий его. Полное наименование класса — system.web.ui.webControis.checkBox.
• Компонент checkBoxlist. Предназначен для создания набора независимых переключателей. Доступ к отдельным переключателям этого компонента осуществляется при помощи свойства items, которое на самом деле является обычной коллекцией. Полное наименование класса — System.Web.UI.WebControls.CheckBoxList.
• Компонент RadioButton. Предназначен для создания кнопки-переключателя. Обычно в одиночном виде не используется. Полное наименование класса — System.Web.UI.WebControls.RadioButton.
• Компонент RadioButtonList. Предназначен для создания группы переключателей. Полное наименование класса, реализующего этот компонент — System.Web.UI.WebControls.RadioButtonList.
• Компонент image. Позволяет внедрять в состав содержимого Web-страницы графическое изображение. Полное наименование класса — System.Web.UI.WebControls.Image.
• Компонент Panel. Создает на разрабатываемой Web-странице блок-контейнер, в котором могут быть размещены другие элементы. По сути, является некоторым аналогом компонентов Layout Panel, находящихся на вкладке HTML. Полное наименование класса — System.web. ui. WebControls. panel.
• Компонент PiaceHoider. Как и предыдущий компонент, он является контейнером для элементов Web-страницы. Однако он предназначен для размещения элементов, которые динамически создаются Web-приложением, т. е. на момент первоначальной загрузки и отображения Web-страницы эти элементы еще не существовали. Полное наименование его класса — System.Web.UI.WebControls.PlaceHolder.
• Компонент calendar. Достаточно интересный компонент, который отображает календарную панель на Web-странице. Очень удобно использовать подобный функциональный элемент на сайтах с большим информационным наполнением, разбитым по датам. Полное наименование класса, реализующего ЭТОТ Компонент, — System.Web.UI.WebControls.Calendar.
• Компонент AdRotator. Позволяет отображать в заданной или случайной последовательности графические изображения. По сути дела, данный элемент является заготовкой для создания баннерной системы. Полное наименование Класса — System. Web.UI.WebControls.AdRotator.
• Компонент таЫе. Предназначен для создания таблиц. Чаще всего используют для отображения некоей информации, взятой из базы данных, в табличном виде. Полное наименование класса — system. web.ui.webcontrois. Table.
• Компонент RequiredFieiavalidator. Данный компонент создает текстовое предупреждение, которое будет отображено, если пользователь при работе с Web-страницей не введет некоторые данные, являющиеся обязательными для продолжения работы. Полное наименование класса — Sy stem. Web. U I .WebControls . RequiredFieldValidator.
• Компонент compareVaiidator. Применяется для проверки равенства или неравенства (соотношение больше-меньше) некоего значения, введенного пользователем. Полное наименование класса, реализующего этот компонент, — System. Web. UI .WebControls .CompareVaiidator.
• Компонент RangeValidator. Позволяет проверять, входит ли введенное пользователем значение, в некий заранее определенный интервал допустимых значений. Полное наименование класса для данного компонента — System. Web. UI .WebControls .RangeValidator.
• Компонент RegularExpressionValidator. Компонент позволяет проверять введенное пользователем значение на соответствие некоему шаблону, большой набор которых предоставлен разработчику в готовом виде, и, кроме того, естественно, разработчик может сам устанавливать свои собственные символьные шаблоны. Полное наименование соответствующего Класса — System. Web. UI .WebControls . RegularExpressionValidator.
• Компонент CustomValidator. Этот компонент, как и несколько предыдущих, относится к контролирующим элементам. Но если в предыдущие компоненты уже встроены механизмы проверки соответствия введенного значени я некоему условию, то данный элемент позволяет разработчику подключат свои собственные функции проверки достоверности введенных данных. Полное наименование класса — System. Web.UI.WebControls.CustomValidator.
• Компонент VaiidationSummary. Предназначен для вывода отчета о несоответствиях данных, введенных пользователем. По сути, данный компо нент является итоговым отчетом, который может быть связан с предыдущими компонентами проверки достоверности. Полное наименованш Класса — System. Web. UI .WebControls .VaiidationSummary.
• Компонент xml. Предназначен для отображения на Web-странице данных, полученных из XML-документов. Естественно, отображение происходит не напрямую, так как браузер не может знать, как именно следуе т отображать содержимое тех или иных XML-тегов. Поэтому с документе ом связывается стилевая таблица XSL, содержащая инструкции по отображению использованных XML-тегов. Полное наименование класса дл я Дан ного Компонента — System. Web.UI.WebControls.Xm l.
• Компонент crystaiReportviewer. Предназначен для внедрения в разрабатываемые Web-страницы различных отчетов, построенных на технологии Crystal Report, которая входит в состав Visual Studio .NET. Полное наименование класса для данного компонента — System.Web.UI.WebControls.CrystaiReportviewer.

На этом перечень компонентов, расположенных на вкладке Web Forms (Web-формы) заканчивается. На самом деле, этого краткого перечня явно недостаточно для того, чтобы работать с этими компонентами. Однако в следующих разделах мы увидим, как их можно использовать.

Объект 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, позволяющего передавать информацию удаленному пользователю, которая затем будет отображена его браузером.

Объект 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 /form-data.
• 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 исчерпан. Настало время перейти к рассмотрению других встроенных объектов.

Объект HttpApplicationState

Доступ к встроенному объекту HttpApplicationState обычно осуществляется при помощи его укороченного наименования — Application. В этом объекте хранятся данные, которые будут доступны всем пользователям, одновременно работающим с Web-приложением. Чаще всего подобный объект разработчики используют как коллекцию для хранения неких данных, которые должны быть доступны сразу нескольким Web-страницам. В одном из следующих разделов мы увидим, как можно использовать этот объект для хранения данных, введенных удаленным пользователем в элементы формы.

Таки м образом, объект Application предоставляет разработчику некий аналог глобальных переменных.

Необходимо осознавать, что к одному и тому же приложению может одновременно обращаться несколько удаленных пользователей. Соответственно, сервер IIS запустит несколько процессов, в каждом из которых будет выполняться копия приложения. Так вот, все эти процессы будут обладать одним объектом Application, общим для всех.

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

• AiiKeys. Свойство представляет собой массив строк, в которых записаны наименования всех элементов коллекции.
• Contents. Свойство представляет собой ссылку на весь объект Application. Обычно применяется для его копирования в иной объект. Однако в ASP.NET нет нужды пользоваться данным свойством, достаточно обратиться к штатным механизмам присваивания значений. Свойство оставлено для обеспечения совместимости с предыдущими версиями ASP.
• Count. Свойство целочисленного типа. В нем указывается количество элементов в коллекции.
• item. Свойство предоставляет доступ к какому-либо конкретному элементу. Доступ может осуществляться по наименованию элемента или его порядковому номеру. Необходимо помнить, что нумерация элементов коллекции начинается с нуля. На самом деле данное свойство используется по умолчанию, поэтому обращение Application.item(O) абсолютно эквивалентно конструкции Application(0).

Естественно, объект обладает и набором методов. Рассмотрим и их.

• Add. Метод добавляет еще одну глобальную переменную в общую коллекцию. В качестве параметров передаются строка с наименованием нового элемента и его значение.
• clear. Метод очищает содержимое коллекции.
• Get. Метод позволяет получить значение определенного элемента коллекции. В качестве параметра методу передается порядковый номер элемента или его уникальное наименование.
• GetKey. Метод позволяет получить значение элемента коллекции. Доступ осуществляется только по