View.ExecuteAction Method (ActionType, String) (Microsoft.Office.InfoPath)
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
An ActionType enumeration that specifies the action to perform.
- xmlToEdit
The ViewContext identifier of the field or group to which to apply the editing action.
Exceptions
| Exception type | Condition |
|---|---|
The ExecuteAction method was called from an event handler for the Loading event. |
|
The parameters passed to this method are null. |
|
The parameters passed to this method arenot 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 ViewContext identifier for a control or group on an InfoPath form in Design mode 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 Office InfoPath 2007.
Example
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")