View.ExecuteAction, méthode (ActionType, String)
Exécute une commande d’édition sur le document XML sous-jacent d’un formulaire, sur la base du champ ou groupe spécifié.
Espace de noms : Microsoft.Office.InfoPath
Assembly : Microsoft.Office.InfoPath (dans Microsoft.Office.InfoPath.dll)
Syntaxe
'Déclaration
Public MustOverride Sub ExecuteAction ( _
action As ActionType, _
xmlToEdit As String _
)
'Utilisation
Dim instance As View
Dim action As ActionType
Dim xmlToEdit As String
instance.ExecuteAction(action, xmlToEdit)
public abstract void ExecuteAction(
ActionType action,
string xmlToEdit
)
Paramètres
- action
Type : Microsoft.Office.InfoPath.ActionType
Énumération ActionType qui spécifie l’action à effectuer.
- xmlToEdit
Type : System.String
L’identificateur ViewContext du champ ou groupe auquel appliquer l’action d’édition.
Exceptions
| Exception | Condition |
|---|---|
| InvalidOperationException | La méthode ExecuteAction a été appelée depuis un gestionnaire d’événements pour l’événement Loading. |
| ArgumentNullException | Les paramètres transmis à cette méthode sont une référence NULL (Nothing dans Visual Basic). |
| ArgumentException | Les paramètres transmis à cette méthode ne sont pas valides. Par exemple, ils sont d’un type ou format incorrect. |
Remarques
La méthode ExecuteAction est utilisée pour effectuer, par programmation, des actions d’édition prédéfinies dans le document XML sous-jacent d’un formulaire, sur la base du contexte sélectionné dans une vue.
L’action exécutée est la même que celle utilisée lorsque vous cliquez sur un menu ou un bouton de barre d’outils équivalent, à savoir celle pour laquelle l’élément bouton du fichier .xsf possède les attributs xmlToEdit et action correspondants. Comme lors de l’utilisation d’un bouton, l’action est basée sur la sélection active : elle agit sur le contexte sélectionné (et dans le cas où la sélection entraîne la désactivation du bouton, la méthode ExecuteAction est sans effet).
Vous pouvez déterminer l’identificateur ViewContext d’un contrôle ou groupe sur un formulaire InfoPath en mode Création en affichant la boîte de dialogue Propriétés du contrôle, puis en cliquant sur l’onglet Avancées.
Notes
Dans certains cas, l’appel de la méthode ExecuteAction à partir d’un gestionnaire d’événements pour l’événement Clicked d’un bouton dans une vue peut générer une erreur. Cela est dû au fait que le contexte sélectionné est remplacé par le bouton lorsque celui-ci est activé. Dans ce cas, il est préférable d’utiliser un bouton ou un lien dans un volet Office personnalisé, un menu ou une barre d’outils pour appeler la méthode ExecuteAction.
Ce membre est accessible uniquement par les formulaires qui s’exécutent dans le même domaine que le formulaire ouvert ou par les formulaires qui disposent d’autorisations valables pour plusieurs domaines.
Ce type ou ce membre est accessible uniquement à partir du code exécuté dans les formulaires ouverts dans Microsoft InfoPath Filler.
Exemples
Dans l’exemple qui suit, la méthode ExecuteAction(action, xmlToEdit) de la classe View est utilisée pour insérer des données dans le groupe spécifié à l’aide de l’action ActionType.XCollectionInsert.
this.CurrentView.ExecuteAction(ActionType.XCollectionInsert,
"group1_1");
Me.CurrentView.ExecuteAction(ActionType.XCollectionInsert, "group1_1")