Поведение WebService

Этот раздел содержит справочные сведения о поведении WebService.

Обзор/учебные материалы

О поведении WebService

Поведение WebService позволяет скрипту на стороне клиента вызывать удаленные методы, предоставленные веб-службами или другими веб-серверами, поддерживающими SOAP и язык WSDL 1.1. Это поведение предоставляет разработчикам возможность использовать SOAP, не требуя экспертного значения реализации SOAP. Поведение WebService поддерживает использование широкого диапазона типов данных, включая собственные типы данных SOAP, массивы, объекты и XML-данные. Поведение WebService реализуется с помощью файла компонента HTML Component (HTC) в качестве подключенного поведения, поэтому оно может использоваться в Microsoft Internet Explorer 5 и более поздних версиях.

Использование поведения WebService

В этой статье объясняется, как использовать поведение WebService для вызова удаленных методов веб-служб. Поведение WebService реализуется с помощью файла HTC в качестве подключенного поведения, поэтому оно может использоваться в Microsoft Internet Explorer 5 и более поздних версиях. Большая часть этой статьи фокусируется на использовании поведения WebService, но она также кратко касается веб-служб, используемых поведением WebService. Статья О поведении WebService содержит дополнительное обсуждение и сведения об основных преимуществах и свойствах поведения WebService, а также содержит множество ссылок на связанные веб-сайты.

Поведение WebService. Поддерживаемые типы данных

В этом документе описываются типы данных ASP.NET и XML, поддерживаемые поведением WebService.

Элементы и объекты

call

Объект скрипта, который может быть передан как параметр в метод callService.

errorDetail

Этот объект предоставляется объектом result, если вызов метода callService приводит к ошибке. Свойства errorDetail содержат подробные сведения об ошибке и ее диагностику.

result

Этот объект предоставляет результаты и краткую диагностику вызова метода callService.

useOptions

Объект, который может быть передан как параметр в метод useService.

Атрибуты и свойства

async

Определяет режим вызова удаленного метода.

code

Машинно-читаемый код ошибки, соответствующий конкретному вызову метода callService.

endpoint

Свойство объекта call, определяющее URL-адрес, который можно использовать, чтобы получить WSDL для веб-службы.

error

Свойство типа Boolean, созданное поведением WebService после вызова метода callService.

funcName

Определяет имя удаленной функции, предоставляемой веб-службой.

id

Свойство объекта result, обладающее уникальным значением, соответствующим конкретному выполнению метода callService.

params

Свойство объекта call, определяющее ассоциативный массив значений параметров.

password

Задает пароль для веб-служб, требующих проверки подлинности пользователя.

portName

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

raw

Предоставляет необработанный пакет данных SOAP, возвращаемый веб-службой после вызова метода callService.

reuseConnection

Определяет сохранение сведений о подключении, необходимое для веб-служб, использующих проверку подлинности с помощью SSL.

serviceAvailable

Показывает, успешно ли вызов метода useService возвратил данные WSDL.

serviceUrl

Определяет URL-адрес веб-службы.

SOAPHeader

Массив заголовков SOAP, переопределяющий заголовок SOAP по умолчанию, созданный поведением WebService.

string

Машинно-читаемое сообщение об ошибке, соответствующее конкретному вызову метода callService.

timeout

Не поддерживается.

userName

Задает имя пользователя для веб-служб, требующих проверки подлинности пользователя.

userName

Возвращает параметр sFriendlyName, переданный в метод useService.

value

Свойство объекта result, созданное во время выполнения.

WSDL

WSDL, возвращенный веб-службой после вызова метода useService.

Методы

callService

Вызывает метод, реализованный в веб-службе.

createCallOptions

Создает экземпляр объекта call, который может быть передан в качестве параметра методу callService.

createUseOptions

Создает объект useOptions, который может быть передан как параметр в метод useService.

useService

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

События

onresult

Происходит при получении результата от удаленного метода callService с помощью поведения WebService.

onserviceavailable

Происходит после попытки поведения WebService получить WSDL от веб-службы.