XmlForm.MergeForm Método

Definição

Namespace:

Microsoft.Office.InfoPath

Assembly:

Microsoft.Office.InfoPath.dll

Sobrecargas

MergeForm(String)	Mescla o formulário atual com o formulário especificado por caminho ou URL.
MergeForm(XPathNavigator)	Mescla o formulário atual com o formulário de destino especificado no nó retornado pelo XPathNavigator passado para o método.

MergeForm(String)

Mescla o formulário atual com o formulário especificado por caminho ou 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

O caminho ou URL para o arquivo de formulário a ser mesclado.

Exceções

ArgumentNullException

O valor passado para fileUrl é uma referência nula (Nada no Visual Basic).

ArgumentException

O valor passado para fileUrl é "" ou é inválido.

InvalidOperationException

O método MergeForm foi chamado do Loading evento.

Exemplos

No exemplo de código a seguir, o método MergeForm da XmlForm classe é usado para mesclar um formulário com o formulário atual.

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

Comentários

O método MergeForm é equivalente ao uso do comando Merge Forms do editor de formulários do InfoPath. O valor passado como parâmetro fileUrl deve ser um caminho completo ou URL e deve incluir o nome do arquivo com uma extensão de arquivo .xml.

This member can be accessed only by forms running in the same domain as the currently open form, or by forms that have been granted cross-domain permissions.

This type or member can be accessed only from code running in forms opened in Microsoft InfoPath Filler.

MergeForm(XPathNavigator)

Mescla o formulário atual com o formulário de destino especificado no nó retornado pelo XPathNavigator passado para o 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

Um XPathNavigator que fornece os dados XML para mesclar no formulário atual.

Exceções

InvalidOperationException

O método MergeForm foi chamado do Loading evento.

ArgumentNullException

O parâmetro passado para esse método é uma referência nula (Nada no Visual Basic).

ArgumentException

O parâmetro passado para esse método não é válido. Por exemplo, ele é do tipo ou formato errado.

Exemplos

No exemplo de código a seguir, um System.Xml. O objeto XmlDocument é usado para carregar um formulário da URL especificada e, em seguida, um System.Xml. O objeto XPath.XPathNavigator está posicionado na raiz do formulário a ser mesclado. Por fim, o XPathNavigator é passado para o MergeForm(System.Xml. Método XPath.XPathNavigator) para mesclar o formulário no formulário atual.

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)

Comentários

O método MergeForm é equivalente ao uso do comando Merge Forms do editor do InfoPath. Os dados XML fornecidos pelo XPathNavigator passaram, pois o target parâmetro deve ser XML válido para mesclar no formulário atual. Se os dados XML fornecidos não forem encapsulados como um formulário InfoPath, o InfoPath encerrará os dados.

This member can be accessed only by forms running in the same domain as the currently open form, or by forms that have been granted cross-domain permissions.

This type or member can be accessed only from code running in forms opened in Microsoft InfoPath Filler.