XmlForm.MergeForm-Methode (XPathNavigator)

Artikel
04/27/2010

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
XPathNavigator, der die im aktuellen Formular zusammenzuführenden XML-Daten bereitstellt.

Ausnahmen

Ausnahmetyp	Bedingung
InvalidOperationException	Die MergeForm-Methode wurde vom Loading-Ereignis aufgerufen.
ArgumentNullException	Der an diese Methode übergebene Parameter lautet null.
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 im Menü Extras enthaltenen Befehl Formulare zusammenführen. Die von XPathNavigator als target-Parameter übergebenen Daten müssen für die Zusammenführung im aktuellen Formular gültige XML-Daten sein. Sind die bereitgestellten XML-Daten nicht als InfoPath-Formular eingebunden, so erfolgt in InfoPath die Einbindung der Daten.

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 Office InfoPath 2007 geöffnet wurden.

Beispiel

Im folgenden Beispiel wird mithilfe des System.Xml.XmlDocument-Objekts ein Formular vom 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)

Siehe auch

Referenz

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

Freigeben über