Создание пользовательской страницы тестирования
Создание пользовательской страницы тестирования
Если вы хотите, чтобы среда выполнения 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.