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
フォーム テンプレートの URL (Uniform Resource Locator) を指定します。このパラメータは、フォーム定義 (.xsf) ファイルまたはフォーム テンプレート (.xsn) ファイルとして指定できます。
- behavior
フォーム テンプレートのインストール方法を指定します。既定値は "overwrite" (上書き保存) です。このパラメータの他の唯一の有効な値は、"new-only" (新規のみ) です。
例外処理
例外の種類 | 条件 |
---|---|
フォーム テンプレート ファイルが見つかりません。 |
|
このメソッドに渡されたパラメータは null です。 |
|
このメソッドに渡されたパラメータは有効ではありません。たとえば、型または形式が正しくありません。 |
コメント
フォーム テンプレートが既に登録されていて、"new-only" が behavior パラメータに指定されている場合、RegisterFormTemplate メソッドはエラーを返します。"overwrite" を指定すると、フォーム テンプレートの登録レコードが上書きされます。
このメンバは、[フォームのオプション] ダイアログ ボックスの [セキュリティと信頼] カテゴリを使用して完全信頼で実行するように構成されているフォーム テンプレートから開かれたフォームだけがアクセスできます。このメンバは、直接呼出し元に対する完全な信頼が必要であり、部分的に信頼されたコードで使用することはできません。詳細については、MSDN の「部分的に信頼されたコードからライブラリを使用する」を参照してください。
この型またはメンバは、Microsoft Office InfoPath 2007 で開いているフォームで実行されているコードからのみアクセスできます。
例
次の例では、Application クラスの RegisterFormTemplate メソッドを関数で使用して、フォーム テンプレートをインストールします。この例では、関数を含むクラスの宣言セクションの Microsoft.Office.InfoPath 名前空間に using ステートメントまたは Imports ステートメントがあり、Visual Studio の [参照の追加] ダイアログ ボックスの [COM] タブで [Microsoft InfoPath 2.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
.NET Framework セキュリティ
- FileIOPermission formTemplateLocation に指定された値の読み取り用。関連する列挙 :System.Security.Permissions.FileIOPermissionAccess.Read
- FileIOPermission フォーム テンプレートのインストール場所のパスへの書き込み用。関連する列挙 :System.Security.Permissions.RegistryPermissionAccess.Write
- RegistryPermission レジストリの HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Office\InfoPath\SolutionsCatalog キーの読み取りおよび書き込み用。関連する列挙 :System.Security.Permissions.RegistryPermissionAccess.Read, System.Security.Permissions.RegistryPermissionAccess.Write
関連項目
参照
Application クラス
Application のメンバ
Microsoft.Office.InfoPath 名前空間