Урок 12. Объект HttpServerUtility

В коллекции встроенных объектов ASP.NET есть и еще один очень интересный объект, который позволяет приложению напрямую оперировать некоторыми установками самого WWW-сервера. Данный объект носит полное наименование HttpServerUtility, к нему можно обращаться и с использованием более короткого (фамильярного) имени — Server. Свойств у него немного, но методов вполне достаточно. В общем и целом, можно сказать, что функциональность данного встроенного объекта, как впрочем, и других объектов, должна удовлетворить самого придирчивого разработчика.

Начнем мы рассмотрение функциональности данного объекта с перечисления его свойств.

MachineName. В свойстве содержится уникальное имя той машины, на которой и функционирует WWW-сервер IIS.
ScriptTimeout. В свойстве содержится целочисленное значение, которое указывает величину тайм-аута, т. е. промежутка времени, в течение которого сервер будет ожидать отклика от пользователя, в секундах. Естественно, свойство позволяет как получать искомую величину, так и явно устанавливать ее.

На этом список свойств заканчивается, и мы переходим к рассмотрению методов объекта.

ciearError. Метод удаляет ранее инициированные исключения, а именно сообщения об ошибках и нештатных ситуациях.
CreateObjectFromCisid. Метод создает на сервере некий СОМ-объект, уникальный идентификатор класса которого (CLSID) передается методу в качестве параметра типа string.
Execute. Метод сам посылает запрос серверу на загрузку в браузер какой-либо Web-страницы. В качестве параметра может быть передано либо имя загружаемой страницы, либо непосредственно отсылаемый в браузер текст и наименование процедуры, пересылающей его.
GetLastError. Метод возвращает значение типа Exception, в котором указывается код самой последней ошибки, возникшей при работе приложения.
HtmiDecode. Метод позволяет декодировать информацию, записанную с применением символьных подстановок HTML. Как известно, многие символы, такие, например, как символы сравнения "больше" или "меньше", нельзя напрямую включать в содержимое HTML-страниц, так как они выполняют служебные функции. Поэтому для таких символов установлены специализированные текстовые подстановки. И искомый метод позволяет конвертировать текст с подобными подстановками в обычную текстовую строку с нормальными символами. В качестве параметра методу передается строка с символьными HTML-подстановками. Метод, в свою очередь, возвращает уже преобразованную строку чистого текста.
HtmiEncode. Метод является обратным преобразованием по отношению к только что рассмотренному. Впрочем, преобразование не всегда будет симметричным. Некоторые символы, не входящие в стандартную кодировку, будут указаны при помощи их шестнадцатеричных кодов.
MapFath. Метод получает в качестве параметра виртуальный путь к какому-либо документу, находящемуся на сервере. В качестве результата возвращается физический путь к данному файлу в стандартной файловой системе сервера.
Transfer. Метод принудительно прекращает передачу пользователю запрошенной страницы и начинает передавать ему содержимое иной страницы, URL которой передан методу в качестве параметра типа String .
urioecode. Метод принимает строку, подвергнутую URL-кодированию, и возвращает ее в виде чистого текста. Следует указать, что URL-кодирование более жесткая процедура, чем HTML-кодирование. Все пробелы заменяются знаком плюса. Все символы, не входящие в стандартный набор ASCII, или имеющие код ниже, чем тридцать три, должны быть представлены в виде их шестнадцатеричных кодов.
UriEncode. Метод принимает в качестве параметра обычную строку и подвергает ее процедуре URL-кодирования. Результат возвращается методом Как ТИП String.

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