WebServiceConnection.Execute Метод

Определение

Пространство имен:

Microsoft.Office.InfoPath

Сборка:

Microsoft.Office.InfoPath.dll

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

public:
 abstract void Execute(System::Xml::XPath::XPathNavigator ^ input, System::Xml::XPath::XPathNavigator ^ output, System::Xml::XPath::XPathNavigator ^ errors);

public abstract void Execute (System.Xml.XPath.XPathNavigator input, System.Xml.XPath.XPathNavigator output, System.Xml.XPath.XPathNavigator errors);

override this.Execute : System.Xml.XPath.XPathNavigator * System.Xml.XPath.XPathNavigator * System.Xml.XPath.XPathNavigator -> unit

Public MustOverride Sub Execute (input As XPathNavigator, output As XPathNavigator, errors As XPathNavigator)

Параметры

input

XPathNavigator

Объект XPathNavigator , расположенный в узле XML для вставки в <элемент SOAP:Body> веб-службы. Указанный узел XML должен содержать XML-код, соответствующий полному набору параметров запроса и их значениям. Для подключения к данным, настроенного как операция запроса, это переопределяет декларативный параметр, который является полями запроса (потомками <dfs:queryFields>) связанного DataSource объекта. Для подключения к данным, настроенного как операция отправки, это переопределяет полный набор сопоставлений фрагментов частей. input Если параметр указан в виде пустой ссылки (Nothing в Visual Basic), используются декларативные параметры.

output

XPathNavigator

Объект XPathNavigator , расположенный в узле XML, в который вставляется содержимое <элемента SOAP:Body> , возвращаемого веб-службой. Для подключения к данным, настроенного как операция запроса, это переопределяет декларативный параметр, который является полями данных (потомками <dfs:dataFields>) связанного DataSource объекта. Для подключения к данным, настроенного как операция отправки, это переопределяет полный набор сопоставлений фрагментов частей. output Если параметр указан в качестве пустой ссылки (Nothing в Visual Basic) для подключения к данным, настроенного как операция запроса, используются декларативные параметры. Если подключение данных настроено как операция отправки, тогда возвращенные данные не записываются вообще.

errors

XPathNavigator

Объект XPathNavigator , расположенный в узле XML, под которым вставляется содержимое текста ошибки, возвращаемого веб-службой в <элементе Fault> , в случае сбоя операции. errors Если параметр указан в виде пустой ссылки (Nothing в Visual Basic), данные об ошибке не записываются вообще.

Исключения

WebException

Ошибка сети при попытке доступа к веб-службе.

ArgumentNullException

Параметры, передаваемые этому методу, являются пустой ссылкой (Nothing в Visual Basic).

ArgumentException

Этому методу переданы недопустимые параметры . Например, неправильный тип или формат.

Примеры

В следующем примере создаются три объекта XmlDocument для работы с методом Execute. Первый xmlDocument заполняется данными, затем создаются три объекта XPathNavigator для передачи inputв качестве параметров , outputи errors метода Execute , и вызывается метод .

// Open connection.
WebServiceConnection wsc = 
   (WebServiceConnection)this.DataConnections["Main query"];

// Create XmlDocuments.
XmlDocument inputDocument = new XmlDocument();
XmlDocument outputDocument = new XmlDocument();
XmlDocument errorsDocument = new XmlDocument();

// Load input document.
inputDocument.LoadXml("<inputValue1>Test</inputValue1><inputValue2>5</inputValue2>")

// Create XPathNavigator objects for documents.
XPathNavigator inputNav = inputDocument.CreateNavigator();
XPathNavigator outputNav = outputDocument.CreateNavigator();
XPathNavigator errorsNav = errorsDocument.CreateNavigator();

// Call Execute method.
wsc.Execute(inputNav, outputNav, errorsNav);

' Open connection.
Dim wsc As WebServiceConnection = _
   DirectCast(Me.DataConnections["Main query"], WebServiceConnection)

' Create XmlDocuments.
Dim inputDocument As XmlDocument = new XmlDocument()
Dim outputDocument As XmlDocument = new XmlDocument()
Dim errorsDocument As XmlDocument = new XmlDocument()

' Load input document.
inputDocument.LoadXml("<inputValue1>Test</inputValue1><inputValue2>5</inputValue2>")

' Create XPathNavigator objects for documents.
Dim inputNav As XPathNavigator = inputDocument.CreateNavigator()
Dim outputNav As XPathNavigator = outputDocument.CreateNavigator()
Dim errorsNav As XPathNavigator = errorsDocument.CreateNavigator()

' Call Execute method.
wsc.Execute(inputNav, outputNav, errorsNav)

Комментарии

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

Подключения к данным, определенные как операции запроса, связаны с определенным объектом DataSource , из которого они получают параметры запроса (содержащиеся в полях запроса, определенных в <узле dfs:queryFields> источника данных формы) и в который они вставляют возвращенные данные (в полях данных, определенных в <узле dfs:dataFields> источника данных формы).

Подключения данных, определенные как операция отправки, содержат сопоставления фрагментов частей, установленные для извлечения данных для параметров запросов из разных поддеревьев DataSource.

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

Метод Execute (XPathNavigator, XPathNavigator, XPathNavigator) переопределяет версию метода Execute по умолчанию, чтобы разрешить определение любого из описанных выше параметров.

Доступ к этому элементу предоставляется только формам, работающим в том же домене, что и текущая открытая форма, а также формам с междоменными правами доступа.

Доступ к этому типу или элементу предоставляется только из кода, выполняющегося в формах, открытых в Microsoft InfoPath Filler или браузере.