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

WebServiceConnection.Execute Метод (XPathNavigator, XPathNavigator, XPathNavigator)

  • Статья

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

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

Синтаксис

'Декларация
Public MustOverride Sub Execute ( _
    input As XPathNavigator, _
    output As XPathNavigator, _
    errors As XPathNavigator _
)
'Применение
Dim instance As WebServiceConnection
Dim input As XPathNavigator
Dim output As XPathNavigator
Dim errors As XPathNavigator

instance.Execute(input, output, errors)

public abstract void Execute (
    XPathNavigator input,
    XPathNavigator output,
    XPathNavigator errors
)

Параметры

  • input
    Объект XPathNavigator, размещенный в узле XML для вставки в элемент <SOAP:Body> веб-службы. Указанный узел XML должен содержать XML-код с полным набором параметров запроса и их соответствующих значений.

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

    • Для подключения данных, настроенного как операция отправки, это переопределяет весь набор сопоставлений фрагментов частей.

    • Если для параметра input указано значение , тогда используются декларативные настройки.

  • output
    Объект XPathNavigator, размещенный в узле XML, под которым будет вставлено содержимое элемента <SOAP:Body>, возвращенного веб-службой.

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

    • Для подключения данных, настроенного как операция отправки, это переопределяет весь набор сопоставлений фрагментов частей.

    • Если для параметра output указано значение для подключения данных, настроенного как операция запроса, тогда используются декларативные настройки. Если подключение данных настроено как операция отправки, тогда возвращенные данные не записываются вообще.

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

Исключения

Тип исключения Условие

WebException

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

ArgumentNullException

Этому методу переданы параметры .

ArgumentException

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

Заметки

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

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

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

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

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

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

Доступ к этому типу или члену имеется из программы, работающей в формах, открытых в Microsoft Office InfoPath 2007 или в веб-обозревателе.

Пример

В следующем примере создаются три объекта 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
Члены WebServiceConnection
Пространство имен Microsoft.Office.InfoPath