WebServiceConnection Класс

Ссылка

Определение

Пространство имен:: Microsoft.Office.InfoPath

Сборка:: Microsoft.Office.InfoPath.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

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

public ref class WebServiceConnection abstract : Microsoft::Office::InfoPath::DataConnection

public abstract class WebServiceConnection : Microsoft.Office.InfoPath.DataConnection

type WebServiceConnection = class
    inherit DataConnection

Public MustInherit Class WebServiceConnection
Inherits DataConnection

Наследование: Object

DataConnection
WebServiceConnection

Примеры

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

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()

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

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

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

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

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

Конструкторы

WebServiceConnection()

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

Свойства

Name	Возвращает имя подключения данных. (Унаследовано от DataConnection)
ServiceUrl	Возвращает или задает URL-адрес, используемый для вызова веб-службы, связанной WebServiceConnection с объектом .
SoapAction	Возвращает или задает значение атрибута soapAction веб-службы, связанной WebServiceConnection с объектом .
Timeout	Возвращает или задает значение времени ожидания в секундах для подключения к данным, связанного WebServiceConnection с объектом .
WsdlUrl	Возвращает URL-адрес файла WSDL для веб-службы, связанной WebServiceConnection с объектом .

Методы

Execute()	В зависимости от класса ConnectionTypeConnection, из которого осуществляется вызов, выполняет операцию отправки или запроса в подключение данных с помощью декларативно определенных значений для отправляемых данных, параметров запроса или извлекаемых данных. (Унаследовано от DataConnection)
Execute(XPathNavigator, XPathNavigator, XPathNavigator)	Переопределяет метод по умолчанию Execute() , унаследованный от DataConnection базового класса, чтобы указать другой источник данных для отправки, другое расположение для вставки возвращаемых данных или расположение для вставки любого возвращенного текста об ошибке.
GenerateDataSetDiffGram()	Для подключения данных, использующего DataSet ADO .NET и возвращающего метод DiffGram, который определяет различия между начальной и текущей версией элементов данных.

Применяется к

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