次の方法で共有

LoadingEventArgs.InputParameters プロパティ

  • [アーティクル]

/InputParameters コマンド ライン オプションを使用して、または URL のクエリ パラメータを使用して指定された入力パラメータを含む IDictionary を取得します。

名前空間: Microsoft.Office.InfoPath
アセンブリ: Microsoft.Office.InfoPath (microsoft.office.infopath.dll 内)

構文

'宣言
Public MustOverride ReadOnly Property InputParameters As IDictionary(Of String, String)
'使用
Dim instance As LoadingEventArgs
Dim value As IDictionary(Of String, String)

value = instance.InputParameters

public abstract IDictionary<string,string> InputParameters { get; }

プロパティ値

入力パラメータを含む IDictionary。

例外処理

例外の種類 条件

InvalidOperationException

呼び出されたメソッドが、入力パラメータを含む IDictionary への書き込みを試みました。

コメント

入力パラメータは、アンパサンド (&) 文字で区切られた 1 つ以上の名前/値ペアで構成され、/InputParameters コマンドライン オプションを使用してコマンド ラインまたはバッチ ファイルからフォーム テンプレートが開かれるときに指定されます。入力パラメータは、フォーム テンプレートが URL から開かれるときにクエリ パラメータを使用して指定される場合もあります。

メモメモ :

IDictionary は通常は読み取り/書き込み可能ですが、InfoPath は、IDictionary に書き込むメソッド (Add メソッドや Clear メソッドなど) の呼び出しを許可しません。InputParameters プロパティによって返される IDictionary への書き込みを行う呼び出しを実行しようとすると、InvalidOperationException がスローされます。

このメンバは、現在開いているフォームと同じドメイン内で実行されているフォーム、またはドメインを越えたアクセス許可を付与されているフォームだけがアクセスできます。

この型またはメンバは、Microsoft Office InfoPath 2007 または Web ブラウザで開いているフォームで実行されているコードからのみアクセスできます。

例

次の例では、次の構文を使用して、コマンド ラインまたは URL から InfoPath フォーム テンプレートを開いています。

コマンド ラインの場合 :

infopath.exe "C:\User Forms\DeptReport.xsn" /InputParameters "Dept=Accounting"

URL の場合 :

https://server/sites/team/forms/DeptReport.xsn?Dept=Accounting

Loading イベント ハンドラは、InputParameters プロパティを使用して、Department フィールドに、/InputParameters コマンドライン オプションまたは URL 入力パラメータを使用して渡された値 "Accounting" を設定します。

public void FormEvents_Loading(object sender, LoadingEventArgs e)
{
   string vDept = e.InputParameters["Dept"];

   XPathNavigator myNav = CreateNavigator();
   myNav.SelectSingleNode("/my:myFields/my:Department",
      NamespaceManager).SetValue(vDept);
}

Public Sub FormEvents_Loading(ByVal sender As Object, _
   ByVal e As LoadingEventArgs)
   Dim vDept As String = e.InputParameters("Dept")

   Dim myNav As XPathNavigator  = CreateNavigator()
   myNav.SelectSingleNode("/my:myFields/my:Department",
      NamespaceManager).SetValue(vDept)
End Sub

関連項目

参照

LoadingEventArgs クラス
LoadingEventArgs のメンバ
Microsoft.Office.InfoPath 名前空間