XmlForm.MergeForm Метод

Определение

Пространство имен:

Microsoft.Office.InfoPath

Сборка:

Microsoft.Office.InfoPath.dll

Перегрузки

MergeForm(String)	Объединяет текущую форму с формой, указанной с помощью пути или URL-адреса.
MergeForm(XPathNavigator)	Объединяет текущую форму с целевой формой, указанной в узле, возвращенном методом XPathNavigator , переданным методу .

MergeForm(String)

Объединяет текущую форму с формой, указанной с помощью пути или 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)

Параметры

fileUrl

String

Путь или URL-адрес к файлу формы для объединения.

Исключения

ArgumentNullException

Значение, переданное для fileUrl , является пустой ссылкой (Nothing в Visual Basic).

ArgumentException

Значение , переданное для fileUrl , равно "" или недопустимо.

InvalidOperationException

Метод MergeForm был вызван из Loading события.

Примеры

В следующем примере кода метод XmlFormMergeForm класса используется для слияния формы с текущей формой.

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

Комментарии

Метод MergeForm эквивалентен использованию команды Merge Forms редактора форм InfoPath. Значение, передаваемое в fileUrl качестве параметра, должно быть полным путем или URL-адресом и должно содержать имя файла с расширением файла .xml.

Доступ к этому элементу предоставляется только формам, работающим в том же домене, что и текущая открытая форма, а также формам с междоменными правами доступа.

Доступ к этому типу или элементу предоставляется только из кода, выполняющегося в формах, открытых в Microsoft InfoPath Filler.

MergeForm(XPathNavigator)

Объединяет текущую форму с целевой формой, указанной в узле, возвращенном методом XPathNavigator , переданным методу .

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)

Параметры

target

XPathNavigator

Метод XPathNavigator, предоставляющий XML-данные для объединения в текущей форме.

Исключения

InvalidOperationException

Метод MergeForm был вызван из Loading события.

ArgumentNullException

Параметр, передаваемый этому методу, является пустой ссылкой (Nothing в Visual Basic).

ArgumentException

Этому методу передан недопустимый параметр. Например, неправильный тип или формат.

Примеры

В следующем примере кода используется объект System.Xml.XmlDocument для загрузки формы с указанного URL-адреса и затем используется объект System.Xml.XPath.XPathNavigator, размещенный в корне формы, для объединения. Наконец XPathNavigator передается методу MergeForm(System.Xml.XPath.XPathNavigator) для объединения формы в текущей форме.

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)

Комментарии

Метод MergeForm эквивалентен использованию команды Merge Forms редактора InfoPath. XML-данные, предоставляемые XPathNavigator , передаваемые в target качестве параметра, должны быть допустимыми XML-данными для слияния с текущей формой. Если предоставленные XML-данные не упакованы в оболочку как форма InfoPath, упаковку данных выполнит приложение InfoPath.

Доступ к этому элементу предоставляется только формам, работающим в том же домене, что и текущая открытая форма, а также формам с междоменными правами доступа.

Доступ к этому типу или элементу предоставляется только из кода, выполняющегося в формах, открытых в Microsoft InfoPath Filler.