(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
target
Tipo: System.Xml.XPath.XPathNavigatorObjeto XPathNavigator que proporciona los datos XML para combinarlos en el formulario actual.
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)