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)
Syntax
'Declaration
Public MustOverride Sub ExecuteAction ( _
action As ActionType, _
xmlToEdit As String _
)
'Usage
Dim instance As View
Dim action As ActionType
Dim xmlToEdit As String
instance.ExecuteAction(action, xmlToEdit)
public abstract void ExecuteAction(
ActionType action,
string xmlToEdit
)
Parameters
action
Type: Microsoft.Office.InfoPath.ActionTypeAn ActionType enumeration that specifies the action to perform.
xmlToEdit
Type: System.StringThe 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.
Exceptions
| Exception | Condition |
|---|---|
| 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. |
Remarks
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.
Note
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.
Examples
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");
Me.CurrentView.ExecuteAction(ActionType.XCollectionInsert, "group1_1")