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

Статья
08/11/2011

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

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

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

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

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

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

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

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

Назад

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

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

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

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

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

Активирует поиск веб-служб по адресу, введенному в поле 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). Дополнительные сведения см. в разделах Locating Web Services и WSDL File Generation for ASP.NET Web Services.

В этой области представлены следующие ссылки:
- Веб-службы в этом решении Содержит список веб-служб, доступных в текущем решении.
- Веб-службы на локальном компьютере Содержит список веб-служб и документов обнаружения, доступных на локальном компьютере.
  
  Для получения сведений по этой ссылке на локальном компьютере должен работать веб-сервер, например 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, щелкните правой кнопкой мыши веб-ссылку в обозревателе решений и нажмите кнопку Обновить веб-ссылку.

Topic	Location
Практическое руководство. Задание расположения WSDL-файлов для веб-служб	Visual Studio Enterprise – конструктор приложений

См. также

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

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

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

См. также

Задачи

Ссылки

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

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

Дополнительные ресурсы