Практическое руководство. Управление созданием WSDL-файлов для веб-служб ASP.NET
Обновлен: Ноябрь 2007
Можно отключить или включить создание WSDL-файлов для всех веб-служб в приложении ASP.NET во время работы с конструктором приложений в Visual Studio Team System Architecture Edition. По умолчанию в среде Visual Studio включено создание WSDL-файлов. Дополнительные сведения см. в разделе Создание WSDL-файлов для веб-служб ASP.NET.
Примечание. |
---|
Отключение или включение создания WSDL-файлов применяется ко всем веб-службам в приложении ASP.NET. Отключение создания WSDL-файлов без указания другого расположения для WSDL-файла блокирует создание веб-ссылок и вызывает ошибку, когда не удается найти WSDL-файл в указанном расположении. Отключение создания WSDL-файлов также приводит к отключению тестовой страницы ASP.NET по умолчанию, которая создается при обращении к URL-адресу веб-службы из обозревателя. Дополнительные сведения см. в разделе Практическое руководство. Переопределение определений привязки WSDL в WSDL-файлах. |
Эту задачу можно выполнить перед реализацией, используя редактор параметров и ограничений. После реализации приложения ASP.NET также можно удалить или добавить соответствующий параметр в файл Web.config, который расположен в проекте приложения или в файле Machine.config веб-сервера, на котором будет развернуто приложения, в зависимости от требуемой области действия.
Отключение создания WSDL-файлов для приложений ASP.NET
Щелкните на диаграмме приложения нужное приложение ASP.NET.
В меню Схема выберите пункт Параметры и ограничения.
В разделе Параметры редактора параметров и ограничений разверните узел Каталог, а затем — узел Конфигурация.
Щелкните узел Конфигурация правой кнопкой мыши, укажите пункт Добавить ресурс, а затем выберите пункт SystemWebSectionGroup.
Щелкните узел SystemWebSectionGroup правой кнопкой мыши, укажите пункт Добавить ресурс, а затем выберите пункт WebServicesSection.
В правой области редактора параметров и ограничений разверните узел Параметры.
В строке Протокол щелкните столбец Значение, а затем нажмите кнопку с многоточием (…).
Откроется редактор коллекции ComplexSetting.
В списке Члены выберите пункт Документация, нажмите кнопку Удалить, а затем — кнопку ОК.
В раздел <System.Web> файла конфигурации Web.config для приложения, который создается после реализации приложения, не включается следующая запись:
<add name="Documentation" />
Эту запись также можно удалить из файла Machine.config веб-сервера, чтобы отключить создание WSDL-файлов для всех приложений ASP.NET на этом сервере.
Включение создания WSDL-файлов для приложений ASP.NET
Выберите на диаграмме нужное приложение ASP.NET.
В меню Схема выберите пункт Параметры и ограничения.
В разделе Параметры редактора параметров и ограничений разверните узел Каталог, а затем — узел Конфигурация.
Разверните узел SystemWebSectionGroup и выберите ресурс WebServicesSection.
В правой области редактора параметров и ограничений разверните узел Параметры.
В строке Протокол щелкните столбец Значение, а затем нажмите кнопку с многоточием (…).
Откроется редактор коллекции ComplexSetting.
В редакторе коллекции ComplexSetting нажмите кнопку Добавить.
В списке Члены появится новый параметр.
В списке свойств параметра задайте для него имя "Documentation" и нажмите кнопку ОК.
В раздел <System.Web> файла Web.config для приложения, который создается после реализации приложения, добавляется следующая запись:
<add name="Documentation" />
Эту запись также можно добавить в файл Machine.config веб-сервера, чтобы включить создание WSDL-файлов для всех приложений ASP.NET на этом сервере.