Application.CacheFormTemplate メソッド
キャッシュ内のフォーム テンプレートを調べ、必要に応じて、発行された場所からそのフォーム テンプレートを更新します。
名前空間: Microsoft.Office.InfoPath
アセンブリ: Microsoft.Office.InfoPath (Microsoft.Office.InfoPath.dll)
構文
'宣言
Public MustOverride Sub CacheFormTemplate ( _
formTemplateLocation As String _
)
'使用
Dim instance As Application
Dim formTemplateLocation As String
instance.CacheFormTemplate(formTemplateLocation)
public abstract void CacheFormTemplate(
string formTemplateLocation
)
パラメーター
- formTemplateLocation
型: System.String
フォーム テンプレートの URI (Uniform Resource Identifier) を指定します。このパラメーターは、フォーム定義 (.xsf) ファイルまたはフォーム テンプレート (.xsn) ファイルとして指定できます。
例外
例外 | 条件 |
---|---|
FileNotFoundException | フォーム テンプレート ファイルが見つかりません。 |
ArgumentNullException | このメソッドに渡されたパラメーターは null 参照 (Visual Basic ではNothing ) です。 |
ArgumentException | このメソッドに渡されたパラメーターは有効ではありません。たとえば、型または形式が正しくありません。 |
解説
現在キャッシュに存在するフォーム テンプレートが、発行場所のフォーム テンプレートに一致する場合、キャッシュは行われません。コンピューターがオフラインで、フォームが既にキャッシュ内にある場合、キャッシュは維持され、更新は発生しません。
このメンバーには、[フォームのオプション] ダイアログ ボックスの [セキュリティ] または [信頼] カテゴリを使用して、完全な信頼を与えられて実行するように構成されたフォーム テンプレートから開かれたフォームのみがアクセスできます。このメンバーは、直接の呼び出し側の完全な信頼が必要であり、部分的に信頼されたコードでは使用できません。詳細については、MSDN の「部分信頼コードからのライブラリの使用」を参照してください。
この型またはメンバーには、Microsoft InfoPath Filler で開かれたフォームを実行中のコードからのみアクセスできます。
例
次の例では、CacheMyFormTemplates カスタム関数は forms 配列に指定された各フォーム テンプレートの場所をループし、その値を評価のために CacheFormTemplate メソッドに渡します。
private string[] _forms =
{
@"\\MyServer\MyForms\MyForm.xsn",
@"\\MyServer\MyForms\manifest.xsf"
};
private void someFunction()
{
...
CacheMyFormTemplates(_forms);
...
}
private void CacheMyFormTemplates(string[] forms)
{
foreach (string form in forms)
{
this.Application.CacheFormTemplate(form);
}
}
権限
-
formTemplateLocation に指定された値の読み取り用。関連する列挙 :FileIOPermissionAccess.Read
-
フォーム テンプレートのキャッシュ ディレクトリへの書き込み用。関連する列挙 :RegistryPermissionAccess.Write