Диалоговое окно "Добавление веб-ссылки"

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

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

Вызов диалогового окна «Добавление веб-ссылки»

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

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

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

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

Элементы пользовательского интерфейса

• Назад
  

  Возврат к предыдущей отображенной странице.

• Вперед
  

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

• Остановить
  

  Остановка загрузки веб-страницы.

• Обновить
  

  Обновление содержимого активной страницы в левой области обозревателя.

• Домашняя страница
  

  Отображение страницы Начало поиска веб-служб в левой области обозревателя.

• Перейти
  

  Активирует поиск веб-служб по адресу, введенному в поле URL-адрес.

• URL-адрес
  Отображает URL-адрес веб-службы, которую должно использовать приложение. Можно выбрать в раскрывающемся списке одну из ранее использовавшихся служб или ввести новый путь, начинающийся с http:// или ftp://. Полный URL-адрес веб-ссылки включает имя домена, имя веб-службы и имя ее файла обнаружения (ASMX, WSDL, DISCO или XSD). Например, допускается ввод адреса следующего вида:

  http://<имя домена>/<имя веб-службы>/<файл обнаружения>.asmx

  На странице Начало поиска веб-служб выполняется поиск веб-служб по указанному пути, после чего отображается описание найденных служб.

  Примечание.

  Платформа .NET Framework не поддерживает автоматическое обнаружение прокси-серверов. Если на компьютере, защищенном брандмауэром, разрабатывается веб-приложение, использующее веб-службы за пределами брандмауэра, в URL-адрес следует включать адрес и порт прокси-сервера сети. Сведения об этих параметрах URL-адреса можно получить у администратора сети. Кроме того, можно задать элемент Элемент <defaultProxy> (параметры сети) файла Machine.config или Web.config. Любой запрос HttpWebRequest, не содержащий свойство Proxy, для которого задано определенное значение, использует прокси-сервер по умолчанию. Дополнительные сведения см. в разделе Configuring Internet Applications.

• Начало поиска веб-служб
  Ссылки на списки доступных веб-служб. При переходе по одной из этих ссылок можно выбрать имя любой из перечисленных доступных веб-служб, чтобы извлечь описание поддерживаемых данной службой методов из файла на языке описания веб-служб (WSDL). Дополнительные сведения см. в разделах Обнаружение веб-служб и Создание WSDL-файлов для веб-служб ASP.NET.

  В этой области представлены следующие ссылки:

  • Веб-службы в этом решении   Содержит список веб-служб, доступных в текущем решении.

  • Веб-службы на локальном компьютере   Содержит список веб-служб и документов обнаружения, доступных на локальном компьютере.

    Для получения сведений по этой ссылке на локальном компьютере должен работать веб-сервер, например Internet Information Services (IIS). Дополнительные сведения об IIS см. в разделе Техническая библиотека IIS (на английском языке).

  • Обзор серверов UDDI в локальной сети   Список доступных в локальной сети серверов, которые предоставляют веб-службы и документы обнаружения с помощью универсальных протоколов описания, обнаружения и интеграции (UDDI).

    Стандартные протоколы UDDI обеспечивают быстрое обнаружение веб-служб организации программным способом. Дополнительные сведения см. в разделе Веб-узел Microsoft UDDI (на английском языке).

• Веб-службы, найденные по этому URL-адресу
  Список имен всех веб-служб, найденных по заданному URL-адресу. Созданная веб-ссылка будет ссылаться на весь этот список. Чтобы изолировать отдельную веб-службу, наведите указатель мыши на нужный элемент в этом списке. Появится всплывающая подсказка с URL-адресом данной службы. Введите URL-адрес этой службы и нажмите кнопку Перейти. В списке останется только выбранная веб-служба. После этого можно добавить ссылку только на эту службу.

• Имя веб-ссылки
  Уникальное имя, которое будет использоваться в коде для программного обращения к выбранной веб-службе. Если введенное имя совпадает с именем существующей веб-службы, в конец имени добавляется номер, делающий новую ссылку уникальной.

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

  Имена веб-ссылок не могут:

  • Содержать один из следующих символов: «/», «?», «:», «\», «*», «"», «<», «>» или «|»;

  • Содержать управляющие символы Юникода;

  • Быть зарезервированными именами. К ним относятся «CON», «AUX», «PRN», «COM1» и «LPT2».

• Добавить ссылку
  Создание новой веб-ссылки в приложении. Эта кнопка активируется, если в поле Веб-службы, находящиеся по этому URL-адресу указана одна или несколько веб-служб, доступных по адресу, введенному в поле URL-адрес. Новая веб-ссылка с именем, введенным в поле Имя веб-ссылки, появится в окне обозревателя решений в узле «Веб-ссылки» текущего проекта. Новая веб-ссылка обеспечивает доступ приложения ко всем перечисленным веб-службам.

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

См. также

Задачи

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

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

Hosting Remote Objects in Internet Information Services (IIS)

Remoting Example: Hosting in Internet Information Services (IIS)

Configuring Internet Applications

Ссылки

На этом компьютере неправильно настроены параметры прокси-сервера и не позволяют искать веб-службы.

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

Доступ к веб-службам в управляемом коде

Проекты, элементы пользовательского интерфейса

Internet Information Services SDK (на английском языке)

Документация Internet Information Services 5.0 (на английском языке)

Консорциум World Wide Web (на английском языке)

Спецификация WSDL (на английском языке)

UDDI.org (на английском языке)

Веб-узел Microsoft UDDI (на английском языке)