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

Предшественниками Windows Communication Foundation (WCF) были службы XML (веб-службы), также известные как службы ASMX.Доступ к веб-службам можно получить так же, как к любой другой службе WCF, путем добавления ссылки на службу. Все ссылки, добавляемые таким способом, будут обрабатываться последней версией .NET Framework.

Во всех приложениях, созданных в предыдущих версиях Visual Studio, еще можно добавлять ссылки, предназначенные для версии 2.0 .NET Framework.Чтобы сделать это, следуйте инструкциям, приведенным в следующем подразделе.

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

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

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

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

2. В диалоговом окне Добавить ссылку на службу нажмите кнопку Дополнительно.

   Появится диалоговое окно Настройки ссылок на службы.

3. В диалоговом окне Настройки ссылок на службы щелкните Добавить веб-ссылку.

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

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

   Примечание

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

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

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

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

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

   Примечание

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

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

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

См. также

Задачи

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

Ссылки

Диалоговое окно "Добавить ссылку на службу"

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

Службы Windows Communication Foundation и службы данных WCF в Visual Studio

Web References in Visual Studio

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

Consuming ASMX and WCF Services Sample