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.XPathNavigator
XPathNavigator, 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 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
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 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 nur über Code zugegriffen werden, der in Formularen ausgeführt wird, die mit 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)