Книга: ЯЗЫК ПРОГРАММИРОВАНИЯ С# 2005 И ПЛАТФОРМА .NET 2.0. 3-е издание

Создание пользовательской страницы тестирования

Создание пользовательской страницы тестирования

Если вы хотите, чтобы среда выполнения ASP.NET применяла пользовательский файл *.aspx для проверки ваших Web-сервисов XML, вы можете встроить в эту страницу дополнительную информацию (например, фирменный знак компании, дополнительные описания сервиса, ссылки на файлы справки и т.д.). Чтобы упростить себе задачу, большинство разработчиков сначала копируют существующий файл DefaultWsdlHelpGenerator.aspx в проект, а затем, используя этот файл в качестве исходного, нужным образом изменяют оригинальный HTML-документ и программный код C#.

Скопируйте файл DefaultWsdlHelpGenerator.aspx в каталог, содержащий HelloWorldWebService.asmx (например, C:HelloWorldWebService). Переименуйте полученную копию в MyCustomWsdlHelpGenerator.aspx и измените какой-нибудь фрагмент HTML-кода, скажем, в области дескриптора ‹title›. Например, измените имеющийся код разметки

‹title›‹%#ServiceName + " " + GetLocalizedText("WebService'')%›‹/title›

на следующий.

‹title›Мой собственный
 ‹%#ServiceName + " " + GetLocalizedText("WebService") %›
‹/title›

После изменения HTML-содержимого создайте файл Web.config и сохраните его в текущем каталоге. Следующие XML-элементы дают указание среде выполнения использовать ваш пользовательский файл *.aspx, а не DefaultWsdlHelpGenerator.aspx.

‹!--Здесь указывается пользовательский файл *.aspx --›
‹configuration›
 ‹system.web›
  ‹webServices›
   ‹wsdlHelpGenerator href="MyCustomWsdlHelpGenerator.aspx" /›
  ‹/webServices›
 ‹/system.web›
‹/configuration›

При запросе своего Web-сервиса вы увидите, что строка заголовка браузера изменится в соответствии с указанным вами пользовательским содержимым. Кстати, если вы захотите отключить генерирование страницы помощи для данного Web-сервиса, вы можете сделать это с помощью элемента ‹remove› в файле Web.config.

‹!-- Отмена генерирования страницы помощи --›
‹configuration›
 ‹system.web›
  ‹webServices›
   ‹protocols›
    ‹!-- Этот элемент отменяет генерирование WSDL-документа --›
    ‹remove name="Documentation"/›
   ‹/protocols›
  ‹/webServices›
 ‹/system.web›
‹/configuration›

Исходный код. Файлы примера HelloWorldWebService размещены в подкаталоге, соответствующем главе 25.

Оглавление книги