Compartir a través de

XmlForm.MergeForm (Método) (XPathNavigator)

  • Artículo

Combina el formulario actual con el formulario de destino especificado en el nodo devuelto por parámetro XPathNavigator que se pasa al método.

Espacio de nombres: Microsoft.Office.InfoPath
Ensamblado: Microsoft.Office.InfoPath (en microsoft.office.infopath.dll)

Sintaxis

'Declaración
Public MustOverride Sub MergeForm ( _
    target As XPathNavigator _
)
'Uso
Dim instance As XmlForm
Dim target As XPathNavigator

instance.MergeForm(target)

public abstract void MergeForm (
    XPathNavigator target
)

Parámetros

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

Excepciones

Tipo de excepción Condición

InvalidOperationException

Se ha llamado al método MergeForm desde el evento Loading.

ArgumentNullException

El parámetro que se ha pasado a este método es null.

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álidos.

Comentarios

El método MergeForm equivale a usar el comando Combinar formularios del menú Archivo. Los datos XML proporcionados por el objeto XPathNavigator que se pasa como parámetro target deben ser válidos para combinarlos en el formulario actual. Si los datos XML proporcionados no se encuentran en un formulario de InfoPath, InfoPath los ajustará.

Sólo pueden tener acceso a este miembro los formularios que se ejecuten en el mismo dominio que el formulario abierto actualmente o los formularios a los que se hayan concedido permisos entre dominios.

Se puede tener acceso a este tipo o miembro solamente desde un código ejecutado en formularios abiertos en Microsoft Office InfoPath 2007.

Ejemplo

En el ejemplo siguiente, 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)

Vea también

Referencia

XmlForm (Clase)
XmlForm (Miembros)
Microsoft.Office.InfoPath (Espacio de nombres)