次の方法で共有


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)。

戻り値

型: 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)

関連項目

参照

XmlFormCollection クラス

XmlFormCollection メンバー

NewFromFormTemplate オーバーロード

Microsoft.Office.InfoPath 名前空間