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