EmailSubmitConnection.Execute(XPathNavigator) Methode

Definition

Namespace:

Microsoft.Office.InfoPath

Assembly:

Microsoft.Office.InfoPath.dll

Überschreibt die Standardmethode Execute() , um die Angabe einer anderen Zu übermittelnden Datenquelle zu ermöglichen.

public:
 abstract void Execute(System::Xml::XPath::XPathNavigator ^ input);

public abstract void Execute (System.Xml.XPath.XPathNavigator input);

override this.Execute : System.Xml.XPath.XPathNavigator -> unit

Public MustOverride Sub Execute (input As XPathNavigator)

Parameter

input

XPathNavigator

XPathNavigator am Ende des XML-Knotens, der die zu sendenden Daten enthält.

Ausnahmen

ArgumentNullException

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

ArgumentException

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

Beispiele

Im folgenden Beispiel wird die Execute(XPathNavigator)-Methode verwendet, um das Formular an die Datenverbindung namens "E-Mail: Absenden" mithilfe der Daten aus der Datenquelle namens "QueryTypedDataSet" (Abfragentypen-Datengruppe) statt aus der primären Datenquelle im Formular zu senden.

public void FormEvents_Submit(object sender, SubmitEventArgs e)
{
   XmlForm myXmlForm = this;
   XPathNavigator myNav = myXmlForm.DataSources[
      "QueryTypedDataSet"].CreateNavigator();

   EmailSubmitConnection mySubmit = (EmailSubmitConnection)myXmlForm.
      DataConnections["Email Submit"];
   mySubmit.Execute(myNav);
}

Public Sub FormEvents_Submit(ByVal sender As Object, _
   ByVal e As SubmitEventArgs)
   Dim myXmlForm As XmlForm = Me
   Dim myNav As XPathNavigator = myXmlForm.DataSources(_
      "QueryTypedDataSet").CreateNavigator()

   EmailSubmitConnection mySubmit = DirectCast( _
      myXmlForm.DataConnections("Email Submit"),EmailSubmitConnection)
   mySubmit.Execute(myNav)
End Sub

Hinweise

Diese Methode überschreibt die Standardmäßige Execute()-Methode (geerbt von der DataConnection Basisklasse), die die Standard Datenquelle des Formulars übermittelt. Das für den input Parameter angegebene XPathNavigator-Objekt sollte auf einen XML-Knoten zeigen, der die zu übermittelnden Daten enthält. Die zu übermittelnden Daten können von jedem - DataSource Objekt angegeben werden.

Das Festlegen des input Parameters auf NULL hat die gleiche Auswirkung wie die Verwendung der Standardmäßigen Execute() -Methode, um das gesamte Formular mithilfe der in der Formularvorlage definierten deklarativen Einstellungen zu übermitteln.

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 über Code zugegriffen werden, der in Formularen ausgeführt wird, die in Microsoft InfoPath Filler oder in einem Webbrowser geöffnet wurden.