Практическое руководство. Добавление и удаление веб-ссылок

Обновлен: Ноябрь 2007

Веб-ссылки позволяют проекту использовать одну или несколько веб-служб XML. Используйте Диалоговое окно "Добавление веб-ссылки", чтобы выполнять поиск веб-служб локально, в локальной сети или в Интернете.

После добавления веб-ссылки к текущему проекту в приложении можно вызывать любые методы, предоставляемые указанной веб-службой. Дополнительные сведения см. в разделе Практическое руководство. Вызов веб-службы.

Сведения о построении класса веб-служб см. в разделе Walkthrough: Building a Basic XML Web Service Using ASP.NET.

Чтобы добавить веб-ссылку в проект

1. В обозревателе решений щелкните правой кнопкой мыши имя проекта, чтобы добавить веб-службу, а затем щелкните Добавить веб-ссылку.

   Появится диалоговое окно Добавить веб-ссылку.

2. В поле URL-адрес введите URL-адрес нужной веб-службы. Если URL-адрес неизвестен, для поиска нужной веб-службы можно воспользоваться ссылками в панели обозревателя.

   Примечание.

   Если на компьютере, защищенном брандмауэром, разрабатывается веб-приложение, использующее веб-службы, находящиеся снаружи брандмауэра, в URL-адрес следует включать адрес и порт прокси-сервера сети. Сведения об этих параметрах URL-адреса можно получить у администратора сети. Дополнительные сведения см. в разделе "На этом компьютере неправильно настроены параметры прокси-сервера для обнаружения веб-служб" для Visual Studio 2005 SDK.

3. В поле Веб-службы, найденные по этому URL-адресу, выберите нужную веб-службу.

4. Проверьте, может ли проект использовать эту веб-службу, и надежен ли внешний код.

   Примечание о безопасности.

   При открытии для редактирования проекта, содержащего веб-ссылку, локальный прокси-файл для используемой веб-службы выполняется в процессе devenv.exe, запущенном доверенным пользователем, т.е. вами. При открытии проектов или компонентов в интегрированной среде разработки (IDE) код может быть выполнен на локальном компьютере. Дополнительные сведения см. в разделах Общие сведения об угрозах безопасности веб-приложений и Управление доступом для кода.

5. В поле Имя веб-ссылки введите имя, которое будет использоваться в коде для программного доступа к выбранной веб-службе.

   Примечание.

   По умолчанию веб-ссылки назначаются пространству имен, соответствующему имени их сервера. Можно изменить это значение и ввести другое имя для пространства имен. Однако для этих имен существует ряд ограничений. Дополнительные сведения о недопустимых символах в именах веб-ссылок см. в разделе Диалоговое окно "Добавление веб-ссылки". Visual Web Developer создает пространство имен на основе имени веб-ссылки путем построения иерархии папок. В самой внутренней папке создается файл WSDL, который ссылается на веб-службу, и вспомогательные файлы — например, файлы обнаружения (DISCO и DISCOMAP) — которые содержат информацию о расположении веб-службы.

6. Нажмите кнопку Добавить ссылку.

   Если веб-узел не содержит папку App_WebReferences, то Visual Studio создаст ее. Затем он создает файлы, которые необходимы для прокси-класса, использующего имя, введенное на шаге 5.

Удаление веб-ссылки

Если в проекте веб-ссылка на веб-службу XML больше не нужна, ее можно удалить.

Удаление веб-ссылки из проекта

• В обозревателе решений щелкните правой кнопкой мыши нужную ссылку на службу, а затем нажмите Удалить.

  Вся информация о ссылке будет удалена из проекта и из локального хранилища.

См. также

Задачи

Практическое руководство. Вызов веб-службы

Пошаговое руководство. Создание и использование веб-службы ASP.NET в Visual Web Developer

Walkthrough: Building a Basic XML Web Service Using ASP.NET

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

XML Web Services Overview