(XPathNavigator) del método XmlForm.MergeForm

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

Excepciones

Excepción Condición
InvalidOperationException

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

ArgumentNullException

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

ArgumentException

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

Comentarios

El método MergeForm equivale a usar el comando Combinar formularios del editor de InfoPath. 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á.

Ú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.

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)

Vea también

Referencia

clase XmlForm

Miembros XmlForm

Sobrecarga MergeForm

Espacio de nombres Microsoft.Office.InfoPath