Application.RegisterFormTemplate メソッド (String, String)
指定したフォーム テンプレートを、フォーム テンプレートの以前の登録レコードにオーバーライドするオプションと共にインストールします。
名前空間: Microsoft.Office.InfoPath
アセンブリ: Microsoft.Office.InfoPath (Microsoft.Office.InfoPath.dll)
構文
'宣言
Public MustOverride Sub RegisterFormTemplate ( _
formTemplateLocation As String, _
behavior As String _
)
'使用
Dim instance As Application
Dim formTemplateLocation As String
Dim behavior As String
instance.RegisterFormTemplate(formTemplateLocation, _
behavior)
public abstract void RegisterFormTemplate(
string formTemplateLocation,
string behavior
)
パラメーター
- formTemplateLocation
型: System.String
フォーム テンプレートの URL (Uniform Resource Locator) を指定します。このパラメーターは、フォーム定義 (.xsf) ファイルまたはフォーム テンプレート (.xsn) ファイルとして指定できます。
- behavior
型: System.String
フォーム テンプレートのインストール方法を指定します。既定値は "overwrite" (上書き保存) です。このパラメーターの他の唯一の有効な値は、"new-only" (新規のみ) です。
例外
| 例外 | 条件 |
|---|---|
| FileNotFoundException | フォーム テンプレート ファイルが見つかりません。 |
| ArgumentNullException | このメソッドに渡されたパラメーターは null 参照 (Visual Basic ではNothing ) です。 |
| ArgumentException | このメソッドに渡されたパラメーターは有効ではありません。たとえば、型または形式が正しくありません。 |
解説
フォーム テンプレートが既に登録されていて、"new-only" が behavior パラメーターに指定されている場合、RegisterFormTemplate メソッドはエラーを返します。"overwrite" を指定すると、フォーム テンプレートの登録レコードが上書きされます。
このメンバーには、[フォームのオプション] ダイアログ ボックスの [セキュリティ] または [信頼] カテゴリを使用して、完全な信頼を与えられて実行するように構成されたフォーム テンプレートから開かれたフォームのみがアクセスできます。このメンバーは、直接の呼び出し側の完全な信頼が必要であり、部分的に信頼されたコードでは使用できません。詳細については、MSDN の「部分信頼コードからのライブラリの使用」を参照してください。
この型またはメンバーには、Microsoft InfoPath Filler で開かれたフォームを実行中のコードからのみアクセスできます。
例
次の例では、Application クラスの RegisterFormTemplate メソッドを関数で使用して、フォーム テンプレートをインストールします。この例では、関数を含むクラスの宣言セクションの Microsoft.Office.InfoPath 名前空間に using ステートメントまたは Imports ステートメントがあり、Visual Studio の [参照の追加] ダイアログ ボックスの [COM] タブで [Microsoft InfoPath 3.0 タイプ ライブラリ] を参照していることを前提としています。
public void InstallForm()
{
Microsoft.Office.InfoPath.Application infoPathApp =
new Microsoft.Office.InfoPath.Application();
infoPathApp.RegisterFormTemplate(@"C:\My Forms\MyFormTemplate.xsn",
"overwrite");
}
Public Sub InstallForm()
Dim infoPathApp As Microsoft.Office.InfoPath.Application = _
new Microsoft.Office.InfoPath.Application()
infoPathApp.RegisterFormTemplate("C:\My Forms\MyFormTemplate.xsn", _
"overwrite")
End Sub
権限
-
formTemplateLocation に指定された値の読み取り用。関連する列挙 :FileIOPermissionAccess.Read
-
フォーム テンプレートのインストール場所のパスへの書き込み用。関連する列挙 :RegistryPermissionAccess.Write
-
レジストリの HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Office\InfoPath\SolutionsCatalog キーの読み取りおよび書き込み用。関連する列挙 :RegistryPermissionAccess.Read, RegistryPermissionAccess.Write