XmlFormCollection.NewFromFormTemplate メソッド (String, XPathNavigator)
指定したフォーム テンプレートと XPathNavigator オブジェクトで指定されるデータを使用して新しいフォームを作成します。
名前空間: Microsoft.Office.InfoPath
アセンブリ: Microsoft.Office.InfoPath (Microsoft.Office.InfoPath.dll)
構文
'宣言
Public MustOverride Function NewFromFormTemplate ( _
formTemplateLocation As String, _
xmlData As XPathNavigator _
) As XmlForm
'使用
Dim instance As XmlFormCollection
Dim formTemplateLocation As String
Dim xmlData As XPathNavigator
Dim returnValue As XmlForm
returnValue = instance.NewFromFormTemplate(formTemplateLocation, _
xmlData)
public abstract XmlForm NewFromFormTemplate(
string formTemplateLocation,
XPathNavigator xmlData
)
パラメーター
- formTemplateLocation
型: System.String
新しいフォームの基になるフォーム テンプレートの URI (Uniform Resource Identifier)。
- xmlData
型: System.Xml.XPath.XPathNavigator
フォームのテンプレートとして使用される XML データを返す XPathNavigator オブジェクト。
戻り値
型: Microsoft.Office.InfoPath.XmlForm
作成された新しいフォームを表す XmlForm オブジェクト。
例外
例外 | 条件 |
---|---|
ArgumentException | このメソッドに渡されるパラメーターは無効です。たとえば、型または形式が正しくありません。 |
ArgumentNullException | このメソッドに渡されたパラメーターは null 参照 (Visual Basic ではNothing ) です。 |
FileNotFoundException | formTemplateLocation に対して指定されたファイルは存在しません。 |
InvalidOperationException | このメソッドは、Loading イベントのイベント ハンドラーから呼び出されました。 |
解説
NewFromFormTemplate メソッドは、既存のフォーム テンプレートに基づいて新しいフォームを作成するためにのみ使用でき、フォームに基づいて新しいフォームを作成するためには使用できません。既存のフォームからフォームを作成するには、New メソッドを使用します。
NewFromFormTemplate メソッドを使用すると、InfoPath で新しいフォームが開き、入力できる状態になります。
このメンバーには、現在開いているフォームと同じドメインで実行中のフォーム、またはクロスドメインのアクセス許可が与えられたフォームのみがアクセスできます。
この型またはメンバーには、Microsoft InfoPath Filler で開かれたフォームを実行中のコードからのみアクセスできます。
例
次のコード例では、XmlFormCollection クラスの NewFromFormTemplate(formTemplateLocation, xmlData) メソッドに既存のフォーム テンプレートの URI および XML データを返す XPathNavigator オブジェクトの URI を渡し、新しいフォームに関連付けられた XmlForm オブジェクトが返されます。
// Create an in-memory XML document.
XmlDocument newDoc = new XmlDocument();
// Load the document with some XML.
newDoc.LoadXml(
"<?xml version=\"1.0\" encoding=\"utf-8\" ?><person><firstName/><lastName/><address/><city/><country/></person>");
// Create an XPathNavigator for the XML file.
XPathNavigator newDocNav = newDoc.CreateNavigator();
// Call NewFromFormTemplate to open new form and load XML.
XmlForm newDocument =
this.Application.XmlForms.NewFromFormTemplate(
@"C:\MyForm.xsn", newDocNav);
' Create an in-memory XML document.
Dim newDoc As XmlDocument = new XmlDocument()
' Create XML to load.
Dim xmlToLoad As String = "<?xml version=" & Quote & "1.0" & Quote & _
" encoding=" & Quote & "utf-8" & Quote & _
" ?><person><firstName/><lastName/><address/>" & _
"<city/><country/></person>"
' Load the document with some XML.
newDoc.LoadXml(
)
' Create an XPathNavigator for the XML file.
Dim newDocNav As XPathNavigator = newDoc.CreateNavigator()
' Call NewFromFormTemplate to open new form and load XML.
Dim newDocument As XmlForm = _
Me.Application.XmlForms.NewFromFormTemplate(_
"C:\MyForm.xsn", newDocNav)