FileSubmitConnection.Execute-Methode (XPathNavigator)
Ü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 FileSubmitConnection
Dim input As XPathNavigator
instance.Execute(input)
public abstract void Execute(
XPathNavigator input
)
Parameter
- input
Typ: System.Xml.XPath.XPathNavigator
Ein XPathNavigator-Objekt am XML-Knoten des Formulars, das die zu sendenden Daten enthält.
Ausnahmen
| Ausnahme | Bedingung |
|---|---|
| WebException | Fehler beim Sendevorgang. |
| ArgumentNullException | Der an diese Methode übergebene Parameter lautet ein Nullverweis (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. |
Hinweise
Diese Methode setzt die standardmäßige Execute-Methode (geerbt von der DataConnection-Basisklasse) außer Kraft, die die in der Formularvorlage deklarativ definierten Daten sendet. Das XPathNavigator-Objekt, das für den input-Parameter angegeben ist, muss auf ein XML-Element zeigen, das die zu sendenden Daten enthält. Die zu sendenden Daten können durch ein beliebiges DataSource-Objekt angegeben werden.
Wenn der input-Parameter auf ein Nullverweis (Nothing in Visual Basic) festgelegt wird, hat dies dieselben Auswirkungen wie die Verwendung der standardmäßigen Execute-Methode zum Senden von Daten mithilfe der in der Formularvorlage definierten deklarativen Einstellungen.
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 InfoPath Filler oder einem Webbrowser geöffnet wurden.
Beispiele
Im folgenden Beispiel wird die Execute(input)-Methode verwendet, um einen Sendevorgang an die durch das FileSubmitConnection-Objekt definierte SharePoint-Bibliothek auszuführen und somit den Inhalt des Knotens UniqueValue in der Hauptdatenquelle des Formulars zu senden.
public void ExecuteInput_Clicked(object sender, ClickedEventArgs e)
{
string UniqueValueXPath = "/my:myFields/my:UniqueValue";
XPathNavigator mainNavigator = MainDataSource.CreateNavigator();
XPathNavigator uniqueValueNavigator =
mainNavigator.SelectSingleNode(UniqueValueXPath,
NamespaceManager);
FileSubmitConnection submitConnection =
(FileSubmitConnection)(DataConnections["SharePoint Library"]);
submitConnection.Execute(uniqueValueNavigator);
}
Public Sub ExecuteInput_Clicked(ByVal sender As Object, _
ByVal e As ClickedEventArgs)
Dim UniqueValueXPath As String = "/my:myFields/my:UniqueValue"
Dim mainNavigator As XPathNavigator =
MainDataSource.CreateNavigator()
Dim uniqueValueNavigator As XPathNavigator =
mainNavigator.SelectSingleNode(UniqueValueXPath,
NamespaceManager)
Dim submitConnection As FileSubmitConnection =
DirectCast(DataConnections["SharePoint Library"], _
FileSubmitConnection)
submitConnection.Execute(uniqueValueNavigator)
End Sub