XmlForm.MergeForm 方法

定义

命名空间:

Microsoft.Office.InfoPath

程序集:

Microsoft.Office.InfoPath.dll

重载

MergeForm(String)	将当前表单与通过路径或 URL 指定的表单合并。
MergeForm(XPathNavigator)	将当前窗体与传递给 方法的 返回 XPathNavigator 的 节点中指定的目标表单合并。

MergeForm(String)

将当前表单与通过路径或 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)

参数

fileUrl

String

要合并的表单文件的路径或 URL。

例外

ArgumentNullException

为 传递 fileUrl 的值是一个 null 引用， (Visual Basic) 中 Nothing。

ArgumentException

为 传递的值 fileUrl 为“”或无效。

InvalidOperationException

MergeForm 方法是从 事件调用的Loading。

示例

在下面的代码示例中，类的 XmlFormMergeForm 方法用于将窗体与当前窗体合并。

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

注解

MergeForm 方法等效于使用 InfoPath 表单编辑器的 Merge Forms 命令。 作为 fileUrl 参数传递的值必须是完整路径或 URL，并且必须包含文件扩展名为 .xml 的文件名。

此成员只能由与当前打开的表单在相同域中运行的表单访问，或者由已授予跨域权限的表单访问。

可以通过 Microsoft InfoPath Filler 中打开的表单中运行的代码访问此类型或成员。

MergeForm(XPathNavigator)

将当前窗体与传递给 方法的 返回 XPathNavigator 的 节点中指定的目标表单合并。

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)

参数

target

XPathNavigator

一个 XPathNavigator，提供要合并到当前表单中的 XML 数据。

例外

InvalidOperationException

MergeForm 方法是从 事件调用的Loading。

ArgumentNullException

传递给此方法的参数是一个 null 引用， (Visual Basic) 中无任何内容。

ArgumentException

传递给此方法的参数无效。 例如，它的类型或格式有误。

示例

在以下代码示例中，System.Xml.XmlDocument 对象用于从指定 URL 中加载表单，然后 System.Xml.XPath.XPathNavigator 对象定位在要合并的表单的根位置处。 最后，XPathNavigator 传递到 MergeForm(System.Xml.XPath.XPathNavigator) 方法以将该表单合并到当前表单。

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)

注解

MergeForm 方法等效于使用 InfoPath 编辑器的 Merge Forms 命令。 XPathNavigator 作为 参数传递target的 XML 数据必须是有效的 XML 数据才能合并到当前表单中。 如果提供的 XML 数据没有包装成 InfoPath 表单，则 InfoPath 将包装这些数据。

此成员只能由与当前打开的表单在相同域中运行的表单访问，或者由已授予跨域权限的表单访问。

可以通过 Microsoft InfoPath Filler 中打开的表单中运行的代码访问此类型或成员。