次の方法で共有


XmlForm.MergeForm メソッド

定義

オーバーロード

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。

例外

に渡される fileUrl 値は null 参照です (Visual Basic では Nothing)。

に渡される fileUrl 値が "" であるか、無効です。

MergeForm メソッドがイベントからLoading呼び出されました。

次のコード例では、 クラスの MergeForm メソッドを XmlForm 使用して、フォームを現在のフォームとマージします。

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

注釈

MergeForm メソッドは、InfoPath フォーム エディターの Merge Forms コマンドを使用する場合と同じです。 パラメーターとして 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

現在のフォームにマージする XML データを提供する XPathNavigator

例外

MergeForm メソッドがイベントからLoading呼び出されました。

このメソッドに渡されるパラメーターは null 参照です (Visual Basic では Nothing)。

このメソッドに渡されるパラメーターは無効です。 たとえば、型または形式が正しくありません。

次のコードの例では、System.Xml.XmlDocument オブジェクトを使用して、指定された URL からフォームを読み込み、次に System.Xml.XPath.XPathNavigator オブジェクトを、マージするフォームのルートに配置します。 最後に、XPathNavigatorMergeForm(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 メソッドは、InfoPath エディターの Merge Forms コマンドを使用する場合と同じです。 パラメーターとして渡される XPathNavigator によって提供される XML データは、現在の target フォームにマージするための有効な XML である必要があります。 提供された XML データが InfoPath フォームとしてラップされていない場合、InfoPath によってデータがラップされます。

このメンバは、現在開いているフォームと同じドメインで実行中のフォーム、またはクロスドメインのアクセス許可が与えられたフォームだけがアクセスできます。

この型またはメンバーには、Microsoft InfoPath Filler で開いたフォームで実行されるコードからのみアクセスできます。

適用対象