XmlFormCollection.NewFromFormTemplate メソッド (String, String, XmlFormOpenMode)
指定したフォーム テンプレートと XPathNavigator オブジェクトで指定されるデータを使用して、指定した XmlFormOpenMode で開く新しいフォームを作成します。
名前空間: Microsoft.Office.InfoPath
アセンブリ: Microsoft.Office.InfoPath (Microsoft.Office.InfoPath.dll)
構文
'宣言
Public MustOverride Function NewFromFormTemplate ( _
formTemplateLocation As String, _
xmlData As String, _
behavior As XmlFormOpenMode _
) As XmlForm
'使用
Dim instance As XmlFormCollection
Dim formTemplateLocation As String
Dim xmlData As String
Dim behavior As XmlFormOpenMode
Dim returnValue As XmlForm
returnValue = instance.NewFromFormTemplate(formTemplateLocation, _
xmlData, behavior)
public abstract XmlForm NewFromFormTemplate(
string formTemplateLocation,
string xmlData,
XmlFormOpenMode behavior
)
パラメーター
- formTemplateLocation
型: System.String
新しいフォームの基になるフォーム テンプレートの URI (Uniform Resource Identifier)。
- xmlData
型: System.String
フォームのテンプレートとして使用される XML データを提供する XML ドキュメントの URI (Uniform Resource Identifier)。
- behavior
型: Microsoft.Office.InfoPath.XmlFormOpenMode
フォームを開く方法を指定する XmlFormOpenMode 列挙。
戻り値
型: 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,behavior) メソッドに既存のフォーム テンプレートの URI、XML データの URI、および XmlFormOpenMode 列挙を渡し、新しいフォームに関連付けられた XmlForm オブジェクトが返されます。
XmlForm newDocument =
this.Application.XmlForms.NewFromFormTemplate(
@"C:\MyForm.xsn", @"C:\MyForm.xml",
XmlFormOpenMode.FailOnVersionOlder);
Dim newDocument As XmlForm = _
Me.Application.XmlForms.NewFromFormTemplate(_
"C:\MyForm.xsn", XmlFormOpenMode.FailOnVersionOlder)