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

View.ExecuteAction Метод

  • Ссылка

Определение

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

Перегрузки

ExecuteAction(ActionType)

Выполняет команду редактирования для связанного XML-документа формы на основе данных, выбранных в представлении.
ExecuteAction(ActionType, String)

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

ExecuteAction(ActionType)

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

public:
 abstract void ExecuteAction(Microsoft::Office::InfoPath::ActionType action);
public abstract void ExecuteAction (Microsoft.Office.InfoPath.ActionType action);
abstract member ExecuteAction : Microsoft.Office.InfoPath.ActionType -> unit
Public MustOverride Sub ExecuteAction (action As ActionType)

Параметры

action
ActionType

Перечисление ActionType , указывающее выполняемое действие.

Исключения

InvalidOperationException

Метод ExecuteAction был вызван из обработчика событий для Loading события.

ArgumentNullException

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

ArgumentException

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

Примеры

В следующем примере метод ViewExecuteAction(action) класса используется для удаления выбранных в данный момент данных и их размещения в буфере обмена.

// Create XPathNavigator and select field.
XPathNavigator textNode = 
   CreateNavigator().SelectSingleNode(
   "/my:myFields/my:field1", NamespaceManager);

// Select text in specified field.
CurrentView.SelectText(textNode);

// Cut selected text.
CurrentView.ExecuteAction(ActionType.Cut);

' Create XPathNavigator and select field.
Dim textNode As XPathNavigator = _
   CreateNavigator().SelectSingleNode( _
   "/my:myFields/my:field1", NamespaceManager)

' Select text in specified field.
CurrentView.SelectText(textNode)

' Cut selected text.
CurrentView.ExecuteAction(ActionType.Cut)

Комментарии

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

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

Можно сначала задать контекст выбора с помощью SelectNodes метода или SelectText метода, а затем вызвать метод ExecuteAction , чтобы действовать в этом контексте.

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

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

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

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

ExecuteAction(ActionType, String)

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

public:
 abstract void ExecuteAction(Microsoft::Office::InfoPath::ActionType action, System::String ^ xmlToEdit);
public abstract void ExecuteAction (Microsoft.Office.InfoPath.ActionType action, string xmlToEdit);
abstract member ExecuteAction : Microsoft.Office.InfoPath.ActionType * string -> unit
Public MustOverride Sub ExecuteAction (action As ActionType, xmlToEdit As String)

Параметры

action
ActionType

Перечисление ActionType , указывающее выполняемое действие.

xmlToEdit
String

Идентификатор XmlToEdit поля или группы, к которым применяется действие редактирования. Чтобы определить идентификатор XmlToEdit поля или группы, щелкните правой кнопкой мыши элемент управления, к которому привязано поле или группа, выберите свойства <типа> элемента управления, а затем перейдите на вкладку Дополнительно. Значение XmlToEdit отображается в разделе Код вкладки.

Исключения

InvalidOperationException

Метод ExecuteAction был вызван из обработчика событий для Loading события.

ArgumentNullException

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

ArgumentException

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

Примеры

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

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

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

Комментарии

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

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

Идентификатор XmlToEdit для элемента управления или группы можно определить в форме InfoPath в Designer, открыв диалоговое окно Свойства элемента управления и выбрав вкладку Дополнительно.

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

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

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

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