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


View3.ExecuteAction(String, Object) Метод

Определение

Выполняет команду редактирования Microsoft InfoPath для базового XML-документа формы на основе данных, выбранных в представлении.

public void ExecuteAction (string bstrAction, object varXmlToEdit);
abstract member ExecuteAction : string * obj -> unit
Public Sub ExecuteAction (bstrAction As String, Optional varXmlToEdit As Object)

Параметры

bstrAction
String

Имя выполняемого действия редактирования.

varXmlToEdit
Object

Имя поля или группы, к которым применяется действие редактирования. Это эквивалентно значению атрибута имени в элементе xmlToEdit файла определения формы (XSF).

Реализации

Комментарии

Метод ExecuteAction служит для программного выполнения встроенных действий редактирования InfoPath для базового XML-документа формы на основе выбранного в представлении контекста.

Выполняемое действие соответствует действию при выборе эквивалентного меню или кнопки в панели инструментов; то есть элемент кнопки в файле XSF имеет соответствующие этому действию атрибуты xmlToEdit и action. Как и с использованием кнопки, действие будет основано на текущем выборе: оно применяется к выбранному контексту (и в случае, когда выбор приводит к отключению кнопки, метод ExecuteAction не действует).

Можно сначала задать контекст выбора с помощью Microsoft.Office.Interop.InfoPath.View3.SelectNodes(Microsoft.Office.Interop.InfoPath.IXMLDOMNode,System.Object,System.Object) метода или Microsoft.Office.Interop.InfoPath.View3.SelectText(Microsoft.Office.Interop.InfoPath.IXMLDOMNode,System.Object) метода, а затем вызвать метод ExecuteAction , чтобы действовать в этом контексте.

Метод ExecuteAction возвращает ошибку в силу следующих причин:

  • Параметр bstrAction не содержит допустимое имя компонента редактирования.
  • Параметр varXmlToEdit не соответствует компоненту редактирования, определенному в представлении.
  • Параметр varXmlToEdit является обязательным для определенного действия редактирования.
  • Действие редактирования не применимо в выбранном контексте.
  • Далее представлена таблица сочетаний параметров, которые можно использовать вместе с методом ExecuteAction.
"Копировать"Копирует выбранные данные в буфер обмена.
"Вставить"Копирует данные из буфера обмена в место вставки.
"Вырезать"Удаляет выбранные данные и копирует их в буфер обмена.
"Delete" («Удалить»)Удаляет выбранные данные.
"xCollection::insert", "xmlToEdit"Вставляет данные, исходя из указанного контекста, с помощью компонента редактирования xCollection. Если текущий выбор входит в контейнер xCollection, заданный его элементом xmlToEdit в файле XSF, тогда данные элемента fragmentToInsert добавляются в этот контейнер.
"xCollection::insertBefore", "xmlToEdit"Вставляет данные до указанного контекста с помощью компонента редактирования xCollection. Если текущий выбор входит в элемент xCollection, заданный его элементом xmlToEdit в файле XSF, тогда данные элемента fragmentToInsert вставляются до элемента.
"xCollection::insertAfter", "xmlToEdit"Вставляет данные после указанного контекста с помощью компонента редактирования xCollection. Если текущий выбор входит в элемент xCollection, заданный его элементом xmlToEdit в файле XSF, тогда данные элемента fragmentToInsert вставляются после элемента.
"xCollection::remove", "xmlToEdit"Удаляет данные из указанного контекста с помощью компонента редактирования xCollection. Если текущий выбор входит в элемент xCollection, заданный его элементом xmlToEdit в файле XSF, тогда этот элемент будет удален.
"xCollection::removeAll", "xmlToEdit"Удаляет все данные, содержащиеся в указанном контексте, с помощью компонента редактирования xCollection. Если текущий выбор входит в контейнер xCollection, как указывает элемент xmlToEdit в файле XSF, тогда этим действием будут удалены все элементы в этом контейнере.
"xReplace::replace", "xmlToEdit"Заменяет данные в указанном контексте с помощью компонента редактирования xReplace. Если текущий выбор входит в элемент xReplace, как указывает элемент xmlToEdit в файле XSF, тогда этот элемент будет заменен данными элемента fragmentToInsert.
"xOptional::insert", "xmlToEdit"Вставляет данные на основе указанного контекста с помощью компонента редактирования xOptional. Если текущий выбор входит в контейнер xOptional, как указывает элемент xmlToEdit в файле XSF, тогда данные элемента fragmentToInsert будут добавлены в этот контейнер.
"xOptional::remove", "xmlToEdit"Удаляет данные из указанного контекста с помощью компонента редактирования xOptional. Если текущий выбор входит в элемент xOptional, как указывает его элемент xmlToEdit в файле XSF, тогда этот элемент будет удален.

Примечание. В некоторых случаях вызов метода ExecuteAction из OnClick для кнопки в представлении может вызвать ошибку. Это происходит потому, что выбранный контекст будет изменен для кнопки при ее нажатии. В подобном случае лучше использовать кнопку (или ссылку) на пользовательской области задач, в панели инструментов или в меню для вызова метода ExecuteAction.

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