Export (0) Print
Expand All

View.ExecuteAction method (ActionType, String)

Executes an editing command against a form's underlying XML document, based on the specified field or group.

Namespace:  Microsoft.Office.InfoPath
Assembly:  Microsoft.Office.InfoPath (in Microsoft.Office.InfoPath.dll)

public abstract void ExecuteAction(
	ActionType action,
	string xmlToEdit
)

Parameters

action
Type: Microsoft.Office.InfoPath.ActionType

An ActionType enumeration that specifies the action to perform.

xmlToEdit
Type: System.String

The XmlToEdit identifier of the field or group to which to apply the editing action.

To determine the XmlToEdit identifier of a field or group, right-click the control to which the field or group is bound, click <Control Type> Properties, and then click the Advanced tab. The XmlToEdit value is displayed in the Code section of the tab.

ExceptionCondition
InvalidOperationException

The ExecuteAction method was called from an event handler for the Loading event.

ArgumentNullException

The parameters passed to this method are a null reference (Nothing in Visual Basic).

ArgumentException

The parameters passed to this method are not valid. For example, they are of the wrong type or format.

The ExecuteAction method is used to programmatically perform built-in editing actions against a form's underlying XML document, based on the selected context in a view.

The action that is executed will be the same action that would be used when clicking on an equivalent menu or toolbar button; namely one for which the button element in the .xsf file has corresponding xmlToEdit and action attributes. As with using a button, the action will be based on current selection: it will act on the selected context (and in the case where the selection would lead the button to be disabled, then the ExecuteAction method will have no effect).

You can determine the XmlToEdit identifier for a control or group on an InfoPath form in the Designer by displaying the control's Properties dialog box, and then clicking the Advanced tab.

NoteNote

In some cases, calling the ExecuteAction method from an event handler for the Clicked event of a button in the view may cause an error. This is because the selected context changes to the button when the button is clicked. In this case, it is better to use a button or link on a custom task pane, menu, or toolbar to call the ExecuteAction method.

This member can be accessed only by forms running in the same domain as the currently open form, or by forms that have been granted cross-domain permissions.

This type or member can be accessed only from code running in forms opened in Microsoft InfoPath Filler.

In the following example, the ExecuteAction(action, xmlToEdit) method of the View class is used to insert data into the specified group using the ActionType.XCollectionInsert action.

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

Community Additions

Show:
© 2014 Microsoft