Класс WebServiceConnection

Статья
04/27/2010

Представляет подключение к веб-службе XML.

Пространство имен: Microsoft.Office.InfoPath
Сборка: Microsoft.Office.InfoPath (в microsoft.office.infopath.dll)

Синтаксис

'Декларация
Public MustInherit Class WebServiceConnection
    Inherits DataConnection
'Применение
Dim instance As WebServiceConnection

public abstract class WebServiceConnection : DataConnection

Заметки

Класс WebServiceConnection представляет подключение данных, созданное в InfoPath с помощью , которое указывает все сведения, необходимые для получения с внешнего источника данных и отправки на него данных с помощью веб-службы.

Класс WebServiceConnection предоставляет свойства, которые можно использовать для получения и установки сведений о вводе подключения данных и строках операций. Также он предоставляет свойство для получения URL-адреса файла языка описания веб-служб (WSDL) веб-службы XML.

Для доступа к объекту WebServiceConnection, связанному с подключением данных, можно использовать свойство DataConnections класса XmlForm, чтобы возвратить подключение из объекта DataConnectionCollection шаблона формы.

Дополнительно к методу по умолчанию Execute, наследуемому из базового класса DataConnection, который выполняет операцию запроса или отправки с помощью значений, определенных посредством объявления в режиме конструктора шаблона формы InfoPath, класс WebServiceConnection также предоставляет метод WebServiceConnection.Execute, который позволяет указать другой источник данных для отправки, другое местоположение для вставки возвращенных данных и способ извлечения ошибок, возвращенных подключением.

Класс WebServiceConnection соответствует интерфейсу WebServiceAdapterObject объектной модели Microsoft Office InfoPath 2003.

Пример

В следующем примере ссылка на объект WebServiceConnection, представляющий подключение с именем "Основной запрос", установлена путем передачи имени в свойство Item класса DataConnectionCollection с последующим преобразованием возвращенного объекта в тип WebServiceConnection.[C#]

WebServiceConnection wsConnection = (WebServiceConnection)this.DataConnections["Main query"];

Dim wsConnection As WebServiceConnection = _
   DirectCast(Me.DataConnections("Main query"), WebServiceConnection)

После установления ссылки можно использовать свойства объекта WebServiceConnection, как показано в следующем примере, который задает переменную строки значению, возвращенному свойством ServiceUrl.

string wsServiceURL = wsConnection.ServiceUrl.ToString();

Dim wsServiceURL As String = _
   string wsServiceURL = wsConnection.ServiceUrl.ToString()

Иерархия наследования

System.Object
Microsoft.Office.InfoPath.DataConnection
Microsoft.Office.InfoPath.WebServiceConnection

Безопасность потока

Все открытые статические (Общие в Visual Basic) члены этого типа потокобезопасны. Потокобезопасность членов экземпляров не гарантируется.

См. также

Ссылка

Члены WebServiceConnection
Пространство имен Microsoft.Office.InfoPath

Поделиться через