View.ExecuteAction Метод (ActionType, String)

Статья
04/27/2010

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

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

Синтаксис

'Декларация
Public MustOverride Sub ExecuteAction ( _
    action As ActionType, _
    xmlToEdit As String _
)
'Применение
Dim instance As View
Dim action As ActionType
Dim xmlToEdit As String

instance.ExecuteAction(action, xmlToEdit)

public abstract void ExecuteAction (
    ActionType action,
    string xmlToEdit
)

Параметры

action
Перечисление ActionType, которое определяет действие для выполнения.

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

Исключения

Тип исключения	Условие
InvalidOperationException	Метод ExecuteAction вызван из обработчика события для события Loading.
ArgumentNullException	Этому методу переданы параметры .
ArgumentException	Этому методу переданы недопустимые параметры . Например, неправильный тип или формат.

Заметки

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

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

Можно определить идентификатор ViewContext для элемента управления или группы в форме InfoPath в режиме конструктора, отобразив диалоговое окно элемента управления и затем выбрав вкладку .

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

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

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

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

Пример

В следующем примере метод ExecuteAction(action, xmlToEdit) класса View используется для вставки данных в указанную группу с помощью действия ActionType.XCollectionInsert.

this.CurrentView.ExecuteAction(ActionType.XCollectionInsert, 
   "group1_1");

Me.CurrentView.ExecuteAction(ActionType.XCollectionInsert, "group1_1")

См. также

Ссылка

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

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