Application.RegisterFormTemplate 메서드 (String, String)

아티클
09/24/2014

양식 서식 파일의 이전 등록 레코드를 덮어쓸지 선택하는 옵션을 제공하면서 지정된 양식 서식 파일을 설치합니다.

네임스페이스: 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	이 메서드에 전달된 매개 변수가 유효하지 않습니다. 예를 들면 유형이나 형식이 잘못되었습니다.

주의

양식 서식 파일이 이미 등록되어 있는 경우 behavior 매개 변수에 "new-only"를 지정하면 RegisterFormTemplate 메서드에서 오류가 반환됩니다. "overwrite"를 지정하면 양식 서식 파일의 등록 레코드를 덮어씁니다.

이 멤버는 양식 옵션 대화 상자의 보안 및 신뢰 범주에서 완전히 신뢰할 수 있는 상태로 실행되도록 구성된 양식 서식 파일에서 연 양식에서만 액세스할 수 있습니다. 이 멤버를 사용하려면 직접 실행 호출자에 대한 전체 신뢰가 필요하며 부분적으로 신뢰할 수 있는 코드에서는 사용할 수 없습니다. 자세한 내용은 MSDN의 "부분적으로 신뢰할 수 있는 코드에서 라이브러리 사용"을 참조하십시오.

이 형식 또는 멤버는 Microsoft InfoPath Filer에서 연 양식에서 실행되는 코드에서만 액세스할 수 있습니다.

예

다음 예제에서는 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

권한

FileIOPermission

formTemplateLocation에 대해 지정된 값에서 읽기 위해 사용됩니다. 관련된 열거형: FileIOPermissionAccess.Read
FileIOPermission

양식 서식 파일이 설치된 경로에 쓰기 위해 사용됩니다. 관련된 열거형: RegistryPermissionAccess.Write
RegistryPermission

레지스트리의 HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Office\InfoPath\SolutionsCatalog 키에 대해 읽거나 쓰기 위해 사용됩니다. 관련된 열거형: RegistryPermissionAccess.Read, RegistryPermissionAccess.Write