Freigeben über

View.ExecuteAction Methode

  • Referenz

Definition

Namespace:
Microsoft.Office.InfoPath
Assembly:
Microsoft.Office.InfoPath.dll

Überlädt

ExecuteAction(ActionType)

Führt basierend auf den Daten, die zurzeit in der Ansicht ausgewählt sind, einen Bearbeitungsbefehl für das einem Formular zugrunde liegende XML-Dokument aus.
ExecuteAction(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.

ExecuteAction(ActionType)

Führt basierend auf den Daten, die zurzeit in der Ansicht ausgewählt sind, einen Bearbeitungsbefehl für das einem Formular zugrunde liegende XML-Dokument aus.

public:
 abstract void ExecuteAction(Microsoft::Office::InfoPath::ActionType action);
public abstract void ExecuteAction (Microsoft.Office.InfoPath.ActionType action);
abstract member ExecuteAction : Microsoft.Office.InfoPath.ActionType -> unit
Public MustOverride Sub ExecuteAction (action As ActionType)

Parameter

action
ActionType

Eine ActionType Enumeration, die die auszuführende Aktion angibt.

Ausnahmen

InvalidOperationException

Die ExecuteAction-Methode wurde von einem Ereignishandler für das Loading Ereignis aufgerufen.

ArgumentNullException

Der an diese Methode übergebene Parameter ist ein NULL-Verweis (Nothing in Visual Basic).

ArgumentException

Der an diese Methode übergebene Parameter ist nicht gültig. Der Parameter weist beispielsweise den falschen Typ oder das falsche Format auf.

Beispiele

Im folgenden Beispiel wird die ExecuteAction(action) -Methode der View -Klasse verwendet, um die aktuell ausgewählten Daten zu löschen und in der Zwischenablage zu platzieren.

// Create XPathNavigator and select field.
XPathNavigator textNode = 
   CreateNavigator().SelectSingleNode(
   "/my:myFields/my:field1", NamespaceManager);

// Select text in specified field.
CurrentView.SelectText(textNode);

// Cut selected text.
CurrentView.ExecuteAction(ActionType.Cut);

' Create XPathNavigator and select field.
Dim textNode As XPathNavigator = _
   CreateNavigator().SelectSingleNode( _
   "/my:myFields/my:field1", NamespaceManager)

' Select text in specified field.
CurrentView.SelectText(textNode)

' Cut selected text.
CurrentView.ExecuteAction(ActionType.Cut)

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.

Bei der ausgeführten Aktion handelt es sich um die gleiche Aktion, die beim Klicken auf ein entsprechendes Menü oder eine Entsprechende Symbolleistenschaltfläche verwendet wird. nämlich eine, für die das Schaltflächenelement in der XSF-Datei die entsprechenden xmlToEdit - und action-Attribute aufweist. Wie bei der Verwendung einer Schaltfläche wird es auf den ausgewählten Kontext angewendet (und wenn die Auswahl dazu führen würde, dass die Schaltfläche deaktiviert wird, hat die ExecuteAction-Methode keine Auswirkungen).

Es ist möglich, zuerst den Auswahlkontext mithilfe der -Methode oder SelectText -SelectNodesMethode festzulegen und dann die ExecuteAction-Methode aufzurufen, um auf diesen Kontext zu reagieren.

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 zu einem Fehler führen. Dies liegt daran, dass die Schaltfläche zum ausgewählten Kontext wird, 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 dieses Mitglied kann nur mithilfe von Formularen zugegriffen werden, die in der gleichen Domäne wie das derzeit geöffnete Formular ausgeführt werden oder denen domänenübergreifende Berechtigungen zugewiesen wurden.

Auf diesen Typ oder dieses Mitglied kann nur über Code zugegriffen werden, der in Formularen ausgeführt wird, die in Microsoft InfoPath Filler geöffnet wurden.

Gilt für:

ExecuteAction(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.

public:
 abstract void ExecuteAction(Microsoft::Office::InfoPath::ActionType action, System::String ^ xmlToEdit);
public abstract void ExecuteAction (Microsoft.Office.InfoPath.ActionType action, string xmlToEdit);
abstract member ExecuteAction : Microsoft.Office.InfoPath.ActionType * string -> unit
Public MustOverride Sub ExecuteAction (action As ActionType, xmlToEdit As String)

Parameter

action
ActionType

Eine ActionType Enumeration, die die auszuführende Aktion angibt.

xmlToEdit
String

Der XmlToEdit-Bezeichner des Felds oder der Gruppe, auf das bzw. die die Bearbeitungsaktion angewendet werden soll. Um den XmlToEdit-Bezeichner eines Felds oder einer Gruppe zu bestimmen, klicken Sie mit der rechten Maustaste auf das Steuerelement, an das das Feld oder die Gruppe gebunden ist, klicken Sie auf <Steuerelementtypeigenschaften> , und klicken Sie dann auf die Registerkarte Erweitert. Der XmlToEdit-Wert wird im Codeabschnitt der Registerkarte angezeigt.

Ausnahmen

InvalidOperationException

Die ExecuteAction-Methode wurde von einem Ereignishandler für das Loading Ereignis aufgerufen.

ArgumentNullException

Die an diese Methode übergebenen Parameter sind ein NULL-Verweis (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.

Beispiele

Im folgenden Beispiel wird die ExecuteAction(action, ) -Methode der View -Klasse verwendet, xmlToEdit um Daten mithilfe der Aktion ActionType.XCollectionInsert in die angegebene Gruppe einzufügen.

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

Me.CurrentView.ExecuteAction(ActionType.XCollectionInsert, "group1_1")

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.

Bei der ausgeführten Aktion handelt es sich um die gleiche Aktion, die beim Klicken auf ein entsprechendes Menü oder eine Entsprechende Symbolleistenschaltfläche verwendet wird. nämlich eine, für die das Schaltflächenelement in der XSF-Datei die entsprechenden xmlToEdit - und action-Attribute aufweist. Wie bei der Verwendung einer Schaltfläche basiert die Aktion auf der aktuellen Auswahl: Sie wirkt auf den ausgewählten Kontext (und wenn die Auswahl dazu führen würde, dass die Schaltfläche deaktiviert wird, hat die ExecuteAction-Methode keine Auswirkungen).

Sie können den XmlToEdit-Bezeichner für ein Steuerelement oder eine Gruppe in einem InfoPath-Formular im Designer ermitteln, 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 zu einem Fehler führen. Dies liegt daran, dass die Schaltfläche zum ausgewählten Kontext wird, 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 dieses Mitglied kann nur mithilfe von Formularen zugegriffen werden, die in der gleichen Domäne wie das derzeit geöffnete Formular ausgeführt werden oder denen domänenübergreifende Berechtigungen zugewiesen wurden.

Auf diesen Typ oder dieses Mitglied kann nur über Code zugegriffen werden, der in Formularen ausgeführt wird, die in Microsoft InfoPath Filler geöffnet wurden.

Gilt für: