XmlForm.MergeForm Méthode

Définition

Espace de noms:

Microsoft.Office.InfoPath

Assembly:

Microsoft.Office.InfoPath.dll

Surcharges

MergeForm(String)	Fusionne le formulaire actif avec le formulaire spécifié par un chemin d’accès ou une URL.
MergeForm(XPathNavigator)	Fusionne le formulaire actif avec le formulaire cible spécifié dans le nœud retourné par le XPathNavigator passé à la méthode .

MergeForm(String)

Fusionne le formulaire actif avec le formulaire spécifié par un chemin d’accès ou une URL.

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)

Paramètres

fileUrl

String

Chemin d’accès ou URL du fichier de formulaire à fusionner.

Exceptions

ArgumentNullException

La valeur passée pour fileUrl est une référence null (Nothing en Visual Basic).

ArgumentException

La valeur passée pour fileUrl est « » ou n’est pas valide.

InvalidOperationException

La méthode MergeForm a été appelée à partir de l’événement Loading .

Exemples

Dans l’exemple de code suivant, la méthode MergeForm de la XmlForm classe est utilisée pour fusionner un formulaire avec le formulaire actif.

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

Remarques

La méthode MergeForm équivaut à utiliser la commande Fusionner Forms de l’éditeur de formulaire InfoPath. La valeur passée en tant que fileUrl paramètre doit être un chemin d’accès complet ou une URL, et doit inclure le nom de fichier avec une extension de fichier .xml.

Seuls les formulaires qui s’exécutent dans le même domaine que le formulaire actuellement ouvert ou les formulaires disposant d’autorisations inter-domaines peuvent accéder à ce membre.

Vous pouvez uniquement accéder à ce type ou à ce membre à partir du code exécuté dans les formulaires ouverts dans Microsoft InfoPath Filler.

MergeForm(XPathNavigator)

Fusionne le formulaire actif avec le formulaire cible spécifié dans le nœud retourné par le XPathNavigator passé à la méthode .

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)

Paramètres

target

XPathNavigator

Objet XPathNavigator qui fournit les données XML à fusionner dans le formulaire actif.

Exceptions

InvalidOperationException

La méthode MergeForm a été appelée à partir de l’événement Loading .

ArgumentNullException

Le paramètre passé à cette méthode est une référence null (Nothing en Visual Basic).

ArgumentException

Le paramètre passé à cette méthode n'est pas valide. Par exemple, le type ou le format est incorrect.

Exemples

Dans l’exemple suivant, un objet System.Xml.XmlDocument est utilisé pour charger un formulaire à partir de l’URL spécifiée puis un objet System.Xml.XPath.XPathNavigator est placé à la racine du formulaire à fusionner. Enfin, l’objet XPathNavigator est passé à la méthode MergeForm(System.Xml.XPath.XPathNavigator) pour fusionner le formulaire dans le formulaire actif.

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)

Remarques

La méthode MergeForm équivaut à utiliser la commande Fusionner Forms de l’éditeur InfoPath. Les données XML fournies par XPathNavigator passées en tant que target paramètre doivent être des données XML valides pour la fusion dans le formulaire actuel. Si les données XML ne sont pas encapsulées en tant que formulaire InfoPath, InfoPath encapsule les données.

Seuls les formulaires qui s’exécutent dans le même domaine que le formulaire actuellement ouvert ou les formulaires disposant d’autorisations inter-domaines peuvent accéder à ce membre.

Vous pouvez uniquement accéder à ce type ou à ce membre à partir du code exécuté dans les formulaires ouverts dans Microsoft InfoPath Filler.