Как отключить страницу справки службы для веб-службы.

  • Статья

Этот раздел посвящен технологии прежних версий. Веб-службы XML и клиенты веб-служб XML должны создаваться с использованием Windows Communication Foundation.

Если в адресной строке веб-обозревателя ввести URL-адрес веб-службы без каких-либо параметров, открывается HTML-страница справки веб-службы, если она включена (а по умолчанию она включена в файле machine.config). Страница справки службы и ее конфигурация более подробно рассматривается в разделе Параметры конфигурации для XML-веб-служб, созданных с помощью ASP.NET.

Отключение страницы справки службы для отдельного веб-приложения

  1. Откройте в текстовом редакторе файл Web.config, находящийся в корневом каталоге веб-приложения. (Если файл Web.config не существует, создайте его).

  2. Измените раздел webServices файла Web.config, явным образом удалив поддержку протокола Documentation.

    <webServices>
     <protocols>
       <remove name="Documentation" />
     </protocols>
</webServices>

  3. Сохраните файл Web.config.

    Изменение конфигурации вступит в силу при следующем запросе к веб-службе, размещенной в этом веб-приложении.

    2tyf2t8t.note(ru-ru,VS.100).gifПримечание
    Удаление протокола Documentation также отключает создание файла WSDL для всех веб-служб в веб-приложении. Это не позволяет клиентам создавать прокси-классы, если только им не предоставлен специально созданный для них файл WSDL. Чтобы запретить показ справочной информации о веб-службах пользователям, не отключая создание WSDL-файла для веб-служб в веб-приложении, можно добавить элемент <wsdlHelpGenerator> в файл Web.config для веб-приложения и в качестве значения атрибута href задать пустую HTML-страницу, созданную для этой цели. Следующий пример кода является фрагментом файла Web.config, задающим в качестве страницы справки службы файл MyBlank.htm в папке docs, содержащейся в папке с файлом Web.config. 

    <webServices>
   <wsdlHelpGenerator href="docs/MyBlank.htm"/>
</webServices>

См. также

Задачи

Как отключить поддержку протоколов для веб-служб
Как включить обнаружение XML-веб-служб

Основные понятия

Параметры конфигурации для XML-веб-служб, созданных с помощью ASP.NET
Развертывание XML-веб-служб

Другие ресурсы

XML-веб-службы с использованием ASP.NET