Freigeben über

XmlForm.MergeForm Methode

  • Referenz

Definition

Namespace:
Microsoft.Office.InfoPath
Assembly:
Microsoft.Office.InfoPath.dll

Überlädt

MergeForm(String)

Führt das aktuelle Formular mit dem über den Pfad oder URL angegebenen Formular zusammen.
MergeForm(XPathNavigator)

Führt das aktuelle Formular mit dem Zielformular zusammen, das im Knoten angegeben ist, der von dem zurückgegeben wird, das XPathNavigator an die -Methode übergeben wird.

MergeForm(String)

Führt das aktuelle Formular mit dem über den Pfad oder URL angegebenen Formular zusammen.

public:
 abstract void MergeForm(System::String ^ fileUrl);
public abstract void MergeForm (string fileUrl);
abstract member MergeForm : string -> unit
Public MustOverride Sub MergeForm (fileUrl As String)

Parameter

fileUrl
String

Der Pfad oder URL der zusammenzuführenden Formulardatei.

Ausnahmen

ArgumentNullException

Der für fileUrl übergebene Wert ist ein NULL-Verweis (Nothing in Visual Basic).

ArgumentException

Der für fileUrl übergebene Wert ist "" oder ist ungültig.

InvalidOperationException

Die MergeForm-Methode wurde aus dem Loading -Ereignis aufgerufen.

Beispiele

Im folgenden Codebeispiel wird die MergeForm-Methode der XmlForm -Klasse verwendet, um ein Formular mit dem aktuellen Formular zusammenzuführen.

this.MergeForm("C:\\MyForms\\SomeOtherForm.xml"); Me.MergeForm("C:\MyForms\SomeOtherForm.xml")

Hinweise

Die MergeForm-Methode entspricht der Verwendung des Befehls Merge Forms des InfoPath-Formular-Editors. Der als fileUrl Parameter übergebene Wert muss ein vollständiger Pfad oder eine URL sein und den Dateinamen mit einer .xml Dateierweiterung enthalten.

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.

Gilt für:

MergeForm(XPathNavigator)

Führt das aktuelle Formular mit dem Zielformular zusammen, das im Knoten angegeben ist, der von dem zurückgegeben wird, das XPathNavigator an die -Methode übergeben wird.

public:
 abstract void MergeForm(System::Xml::XPath::XPathNavigator ^ target);
public abstract void MergeForm (System.Xml.XPath.XPathNavigator target);
abstract member MergeForm : System.Xml.XPath.XPathNavigator -> unit
Public MustOverride Sub MergeForm (target As XPathNavigator)

Parameter

target
XPathNavigator

XPathNavigator, der die im aktuellen Formular zusammenzuführenden XML-Daten bereitstellt.

Ausnahmen

InvalidOperationException

Die MergeForm-Methode wurde aus dem Loading -Ereignis aufgerufen.

ArgumentNullException

Der an diese Methode übergebene Parameter ist ein NULL-Verweis (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.

Beispiele

Im folgenden Codebeispiel wird eineSystem.Xml. Das XmlDocument-Objekt wird verwendet, um ein Formular aus der angegebenen URL und dann eine System.Xml zu laden. Das XPath.XPathNavigator-Objekt wird im Stammverzeichnis des zusammenzuführenden Formulars positioniert. Schließlich wird der XPathNavigator an mergeForm(System.Xml. XPath.XPathNavigator) -Methode zum Zusammenführen des Formulars mit dem aktuellen Formular. 

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)

Hinweise

Die MergeForm-Methode entspricht der Verwendung des Befehls Merge Forms des InfoPath-Editors. Die von XPathNavigator bereitgestellten XML-Daten, die target als Parameter übergeben werden, müssen gültiges XML für das Zusammenführen mit dem aktuellen Formular 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.

Gilt für: