XmlForm.MergeForm Método

Definición

Espacio de nombres:

Microsoft.Office.InfoPath

Ensamblado:

Microsoft.Office.InfoPath.dll

Sobrecargas

MergeForm(String)	Combina el formulario actual con el formulario especificado mediante la ruta de acceso o la dirección URL.
MergeForm(XPathNavigator)	Combina el formulario actual con el formulario de destino especificado en el nodo devuelto por el XPathNavigator pasado al método .

MergeForm(String)

Combina el formulario actual con el formulario especificado mediante la ruta de acceso o la dirección 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)

Parámetros

fileUrl

String

Ruta de acceso o dirección URL del formulario que se va a combinar.

Excepciones

ArgumentNullException

El valor pasado para fileUrl es una referencia nula (Nothing en Visual Basic).

ArgumentException

El valor pasado para fileUrl es "" o no es válido.

InvalidOperationException

Se llamó al método MergeForm desde el Loading evento .

Ejemplos

En el siguiente ejemplo de código, se usa el método MergeForm de la XmlForm clase para combinar un formulario con el formulario actual.

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

Comentarios

El método MergeForm equivale a usar el comando Merge Forms del editor de formularios de InfoPath. El valor pasado como fileUrl parámetro debe ser una ruta de acceso completa o una dirección URL y debe incluir el nombre de archivo con una extensión de archivo .xml.

Únicamente se puede acceder a este miembro con formularios que se ejecuten en el mismo dominio que el formulario que está actualmente abierto o con formularios a los que se hayan concedido permisos entre dominios.

Únicamente se puede acceder a este tipo o miembro desde el código que se ejecuta en los formularios abiertos en Microsoft InfoPath Filler.

MergeForm(XPathNavigator)

Combina el formulario actual con el formulario de destino especificado en el nodo devuelto por el XPathNavigator pasado al método .

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)

Parámetros

target

XPathNavigator

Objeto XPathNavigator que proporciona los datos XML para combinarlos en el formulario actual.

Excepciones

InvalidOperationException

Se llamó al método MergeForm desde el Loading evento .

ArgumentNullException

El parámetro pasado a este método es una referencia nula (Nothing en Visual Basic).

ArgumentException

El parámetro que se ha pasado a este método no es válido. Por ejemplo, es de un tipo o formato no válido.

Ejemplos

En el siguiente ejemplo de código, se usa un objeto System.Xml.XmlDocument para cargar un formulario desde la dirección URL especificada y, a continuación, se sitúa un objeto System.Xml.XPath.XPathNavigator en la raíz del formulario que se va a combinar. Por último, se pasa el parámetro XPathNavigator al método MergeForm(System.Xml.XPath.XPathNavigator) para combinar el formulario con el formulario actual.

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)

Comentarios

El método MergeForm equivale a usar el comando Merge Forms del editor de InfoPath. Los datos XML proporcionados por XPathNavigator pasados como target parámetro deben ser XML válidos para la combinación en el formulario actual. Si los datos XML proporcionados no se encuentran en un formulario de InfoPath, InfoPath los ajustará.

Únicamente se puede acceder a este miembro con formularios que se ejecuten en el mismo dominio que el formulario que está actualmente abierto o con formularios a los que se hayan concedido permisos entre dominios.

Únicamente se puede acceder a este tipo o miembro desde el código que se ejecuta en los formularios abiertos en Microsoft InfoPath Filler.