Share via


XmlForm.MergeForm method (String)

Merges the current form with the form specified by path or URL.

Namespace:  Microsoft.Office.InfoPath
Assembly:  Microsoft.Office.InfoPath (in Microsoft.Office.InfoPath.dll)

Syntax

'Declaration
Public MustOverride Sub MergeForm ( _
    fileUrl As String _
)
'Usage
Dim instance As XmlForm
Dim fileUrl As String

instance.MergeForm(fileUrl)
public abstract void MergeForm(
    string fileUrl
)

Parameters

  • fileUrl
    Type: System.String

    The path or URL to the form file to merge.

Exceptions

Exception Condition
ArgumentNullException

The value passed for fileUrl is a null reference (Nothing in Visual Basic).

ArgumentException

The value passed for fileUrl is "" or is invalid.

InvalidOperationException

The MergeForm method was called from the Loading event.

Remarks

The MergeForm method is equivalent to using the Merge Forms command of the InfoPath form editor. The value passed as the fileUrl parameter must be a full path or URL, and must include the filename with an .xml file extension.

This member can be accessed only by forms running in the same domain as the currently open form, or by forms that have been granted cross-domain permissions.

This type or member can be accessed only from code running in forms opened in Microsoft InfoPath Filler.

Examples

In the following code example, the MergeForm method of the XmlForm class is used to merge a form with the current form.

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

See also

Reference

XmlForm class

XmlForm members

MergeForm overload

Microsoft.Office.InfoPath namespace