EmailSubmitConnection.Execute-Methode (XPathNavigator)

Artikel
04/27/2010

Überschreibt die standardmäßige Execute-Methode, um eine andere Datenquelle zum Senden zuzulassen.

Namespace: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in microsoft.office.infopath.dll)

Syntax

'Declaration
Public MustOverride Sub Execute ( _
    input As XPathNavigator _
)
'Usage
Dim instance As EmailSubmitConnection
Dim input As XPathNavigator

instance.Execute(input)

public abstract void Execute (
    XPathNavigator input
)

Parameter

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

Ausnahmen

Ausnahmetyp	Bedingung
ArgumentNullException	Der an diese Methode übergebene Parameter ist null.
ArgumentException	Der an diese Methode übergebene Parameter ist ungültig. Er weist z. B. den falschen Typ oder das falsche Format auf.

Hinweise

Diese Methode überschreibt die standardmäßige Execute()-Methode (geerbt von der DataConnection-Basisklasse), die die primäre Datenquelle des Formulars sendet. Das XPathNavigator-Objekt, das für den input-Parameter angegeben ist, muss auf einen XML-Knoten zeigen, der die zu sendenden Daten enthält. Die zu sendenden Daten können durch ein beliebiges DataSource-Objekt angegeben werden.

Wenn der input-Parameter auf null festgelegt wird, hat dies dieselben Auswirkungen wie die Verwendung der standardmäßigen Execute()-Methode, um das gesamte Formular mithilfe der deklarativen Einstellungen zu senden, die in der Formularvorlage definiert sind.

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

Beispiel

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

Siehe auch

Referenz

EmailSubmitConnection-Klasse
EmailSubmitConnection-Member
Microsoft.Office.InfoPath-Namespace

Freigeben über