XmlForm.MergeForm-Methode (XPathNavigator)
Führt das aktuelle Formular mit dem im Knoten angegebenen Zielformular zusammen. Dies ist der von XPathNavigator, der an die Methode übergeben wurde, zurückgegebene Knoten.
Namespace: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in Microsoft.Office.InfoPath.dll)
Syntax
'Declaration
Public MustOverride Sub MergeForm ( _
target As XPathNavigator _
)
'Usage
Dim instance As XmlForm
Dim target As XPathNavigator
instance.MergeForm(target)
public abstract void MergeForm(
XPathNavigator target
)
Parameter
target
Typ: System.Xml.XPath.XPathNavigatorXPathNavigator, der die im aktuellen Formular zusammenzuführenden XML-Daten bereitstellt.
Ausnahmen
| Ausnahme | Bedingung |
|---|---|
| InvalidOperationException | Die MergeForm-Methode wurde vom Loading-Ereignis aufgerufen. |
| ArgumentNullException | Der an diese Methode übergebene Parameter ist ein Nullverweis (Nothing in Visual Basic). |
| ArgumentException | Der an diese Methode übergebene Parameter ist nicht gültig. Er weist beispielsweise den falschen Typ oder das falsche Format auf. |
Hinweise
Die MergeForm-Methode entspricht dem Befehl Formulare zusammenführen im InfoPath Editor. Die von XPathNavigator als target-Parameter übergebenen XML-Daten müssen für die Zusammenführung im aktuellen Formular gültiger XML-Code sein. Sind die bereitgestellten XML-Daten nicht als InfoPath-Formular eingebunden, erfolgt die Einbindung der Daten in InfoPath.
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.
Beispiele
Im folgenden Codebeispiel wird mit einem System.Xml.XmlDocument-Objekt ein Formular von der angegebenen URL geladen, anschließend ein System.Xml.XPath.XPathNavigator-Objekt am Stamm des zusammenzuführenden Formulars positioniert und zum Schluss XPathNavigator an die MergeForm(System.Xml.XPath.XPathNavigator)-Methode übergeben, um das Formular mit dem aktuellen Formular zusammenzuführen.
string pathToFile = @"C:\FormToMerge\Form1.xml";
XmlDocument FormXML = new XmlDocument();
// The form tempate must be Full Trust for the
// XmlDocument.Load method to work.
FormXML.Load(pathToFile);
XPathNavigator nav = FormXML.CreateNavigator();
// Merge the root node (the entire document) into the current form.
this.MergeForm(nav);
Dim pathToFile As String = "C:\FormToMerge\Form1.xml"
Dim FormXML As New XmlDocument
' The form tempate must be Full Trust for the
' XmlDocument.Load method to work.
FormXML.Load(pathToFile)
Dim nav As XPathNavigator = FormXML.CreateNavigator()
' Merge the root node (the entire document) into the current form.
Me.MergeForm(nav)