Веб-ссылки в Visual Studio

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

В Visual Studio представлен механизм веб-ссылок, упрощающий разработку клиентских приложений веб-служб XML. Веб-ссылки отличаются от обычных ссылок и компонентов, так как они ссылаются не на компонент или библиотеку классов, установленные на локальном компьютере, а предоставляют доступ к ресурсам, доступным через протоколы Интернета, такие как SOAP и HTTP.

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

tydxdyw9.alert_note(ru-ru,VS.90).gifПримечание.

Чтобы сделать веб-службы XML, работающие вне брандмауэра, доступными для обозревателя, при создании веб-ссылки в Visual Studio необходимо явно указать адрес и порт сетевого прокси-сервера.

Язык программирования созданного класса прокси будет тем же, что и у веб-ссылки, которую представляет класс прокси. Если класс прокси создается независимо от Visual Studio (например, при помощи средства .NET Framework), то язык программирования будет зависеть от используемого средства. Например, при использовании WSDL.exe язык программирования (Visual C# или Visual Basic) указывается в командной строке. При использовании SProxy.exe в качестве языка программирования используется Visual C++. Дополнительные сведения см. в разделе Web Services Description Language Tool (Wsdl.exe).

Во время разработки класс прокси позволяет использовать завершение операторов для методов веб-служб XML. Во время выполнения вызов метода объекта прокси обрабатывается и кодируется как сообщение-запрос SOAP. Если веб-служба XML не поддерживает протокол SOAP, то класс прокси использует метод HTTP POST или HTTP GET. Затем сообщение отправляется целевой веб-службе на обработку. Если в описании службы предусмотрено ответное сообщение, то объект прокси обрабатывает это сообщение и возвращает ответ приложению клиента.

Управление веб-ссылками

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

Свойство поведения URL

Все веб-ссылки в проекте взаимодействуют с классами прокси, которые используются для доступа к соответствующим веб-службам. С помощью свойства URL веб-ссылки можно задать URL-адрес веб-службы XML. В ASP.NET 1.1 веб-ссылка может использовать как статический, так и динамический URL-адрес. В ASP.NET 2.0 и более поздних версиях веб-ссылка получает URL-адрес динамически. Дополнительные сведения см. в разделе Обнаружение веб-служб.

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

Если же выбрать динамическое поведение URL веб-ссылку, то приложение получит URL-адрес во время выполнения из элемента appSettings файла конфигурации приложения.

См. также

Задачи

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

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

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

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

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

XML Web Service Discovery

Creating an XML Web Service Proxy

Ссылки

Web Services Description Language Tool (Wsdl.exe)