XmlFormCollection.NewFromFormTemplateWithInputParameters メソッド
指定したフォーム テンプレートと入力パラメーターを使用して新しいフォームを作成します。
名前空間: Microsoft.Office.InfoPath
アセンブリ: Microsoft.Office.InfoPath (Microsoft.Office.InfoPath.dll)
構文
'宣言
Public MustOverride Function NewFromFormTemplateWithInputParameters ( _
formTemplateLocation As String, _
inputParameters As String _
) As XmlForm
'使用
Dim instance As XmlFormCollection
Dim formTemplateLocation As String
Dim inputParameters As String
Dim returnValue As XmlForm
returnValue = instance.NewFromFormTemplateWithInputParameters(formTemplateLocation, _
inputParameters)
public abstract XmlForm NewFromFormTemplateWithInputParameters(
string formTemplateLocation,
string inputParameters
)
パラメーター
- formTemplateLocation
型: System.String
新しいフォームの基になるフォーム テンプレートの URI (Uniform Resource Identifier)。
- inputParameters
型: System.String
アンパサンド (&) 文字で区切られた 1 つ以上の名前/値ペア。
戻り値
型: Microsoft.Office.InfoPath.XmlForm
新しいフォームを表すオブジェクト。
例外
| 例外 | 条件 |
|---|---|
| ArgumentException | このメソッドに渡されるパラメーターは無効です。たとえば、型または形式が正しくありません。 |
| ArgumentNullException | このメソッドに渡されたパラメーターは null 参照 (Visual Basic ではNothing ) です。 |
| FileNotFoundException | formTemplateLocation に対して指定されたファイルは存在しません。 |
| InvalidOperationException | このメソッドは、Loading イベントのイベント ハンドラーから呼び出されました。 |
解説
inputParameters パラメーターに渡された入力パラメーターを使用するには、入力パラメーターの値を取得し、それらの値を使用して何らかの処理を実行するために、LoadingEventArgs クラスの InputParameters プロパティを使用する Loading イベント ハンドラーが、formTemplateLocation パラメーターに指定されたフォームに含まれている必要があります。この方法の例については、InputParameters プロパティのトピックを参照してください。
この型またはメンバーには、Microsoft InfoPath Filler で開かれたフォームを実行中のコードからのみアクセスできます。
このメンバーには、[フォームのオプション] ダイアログ ボックスの [セキュリティ] または [信頼] カテゴリを使用して、完全な信頼を与えられて実行するように構成されたフォーム テンプレートから開かれたフォームのみがアクセスできます。このメンバーは、直接の呼び出し側の完全な信頼が必要であり、部分的に信頼されたコードでは使用できません。詳細については、MSDN の「部分信頼コードからのライブラリの使用」を参照してください。
例
次のコード例では、適切な Loading イベント ハンドラーおよび 2 つの入力パラメーターを含むフォーム テンプレートの URI で渡して、新しいフォームを作成する方法を示しています。
XmlForm newDocument =
this.Application.XmlForms.NewFromFormTemplateWithParameters(
@"C:\User Forms\DeptReport.xsn","Dept=Accounting&Acct=Contoso");
Dim newDocument As XmlForm = _
Me.Application.XmlForms.NewFromFormTemplateWithParameters( _
"C:\User Forms\DeptReport.xsn","Dept=Accounting&Acct=Contoso")