View.ExecuteAction-Methode (ActionType, String)
Führt basierend auf dem angegebenen Feld oder der angegebenen Gruppe einen Bearbeitungsbefehl für das einem Formular zugrunde liegende XML-Dokument aus.
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
)
Parameter
- action
Typ: Microsoft.Office.InfoPath.ActionType
Eine ActionType-Enumeration, die die auszuführende Aktion angibt.
- xmlToEdit
Typ: System.String
Der ViewContext-Bezeichner des Felds oder der Gruppe, auf das bzw. die die Bearbeitungsaktion angewendet werden soll.
Ausnahmen
| Ausnahme | Bedingung |
|---|---|
| InvalidOperationException | Die ExecuteAction-Methode wurde aus einem Ereignishandler für das Loading-Ereignis aufgerufen. |
| ArgumentNullException | Die an diese Methode übergebenen Parameter sind ein Nullverweis (Nothing in Visual Basic). |
| ArgumentException | Die an diese Methode übergebenen Parameter sind nicht gültig. Die Parameter weisen beispielsweise den falschen Typ oder das falsche Format auf. |
Hinweise
Die ExecuteAction-Methode wird verwendet, um integrierte Bearbeitungsaktionen für das einem Formular zugrunde liegende XML-Dokument, basierend auf dem in einer Ansicht ausgewählten Kontext, programmgesteuert auszuführen.
Die ausgeführte Aktion ist mit der Aktion identisch, die beim Klicken auf einen entsprechenden Menübefehl oder eine entsprechende Symbolleisten-Schaltfläche ausgeführt wird. Sie entspricht also der Aktion, bei der das Schaltflächenelement in der XSF-Datei entsprechende Werte für die Attribute xmlToEdit und action aufweist. Wie bei der Verwendung einer Schaltfläche basiert die Aktion auf der aktuellen Auswahl und wird für den ausgewählten Kontext ausgeführt (sollte die Auswahl bewirken, dass die Schaltfläche deaktiviert wird, hat die ExecuteAction-Methode keine Auswirkung).
Sie können den ViewContext-Bezeichner für ein Steuerelement oder eine Gruppe in einem InfoPath-Formular im Entwurfsmodus bestimmen, indem Sie das Dialogfeld Eigenschaften des Steuerelements anzeigen und dann auf die Registerkarte Erweitert klicken.
Hinweis
In einigen Fällen kann das Aufrufen der ExecuteAction-Methode aus einem Ereignishandler für das Clicked-Ereignis einer Schaltfläche in der Ansicht einen Fehler verursachen. Dies liegt daran, dass der ausgewählte Kontext der Schaltfläche sich ändert, sobald auf sie geklickt wird. In diesem Fall empfiehlt es sich, eine Schaltfläche oder eine Verknüpfung in einem benutzerdefinierten Aufgabenbereich, in einem benutzerdefinierten Menü oder auf einer benutzerdefinierten Symbolleiste zu verwenden, um die ExecuteAction-Methode aufzurufen.
Auf den Member kann nur über Formulare zugegriffen werden, die in derselben Domäne wie das zurzeit geöffnete Formular ausgeführt werden, oder über Formulare, denen domänenübergreifende Berechtigungen erteilt wurden.
Auf diesen Typ oder diesen Member kann nur über Code zugegriffen werden, der in Formularen ausgeführt wird, die mit Microsoft InfoPath Filler geöffnet wurden.
Beispiele
Im folgenden Beispiel wird die ExecuteAction(action, xmlToEdit)-Methode der View-Klasse verwendet, um Daten mithilfe der ActionType.XCollectionInsert-Aktion in die angegebene Gruppe einzufügen.
this.CurrentView.ExecuteAction(ActionType.XCollectionInsert,
"group1_1");
Me.CurrentView.ExecuteAction(ActionType.XCollectionInsert, "group1_1")