FormEvents.VersionUpgrade 이벤트
열고 있는 양식의 버전 번호가 기반으로 사용되는 양식 서식 파일의 버전 번호보다 오래된 경우에 발생합니다.
네임스페이스: Microsoft.Office.InfoPath
어셈블리: Microsoft.Office.InfoPath(Microsoft.Office.InfoPath.dll)
구문
‘선언
Public MustOverride Event VersionUpgrade As VersionUpgradeEventHandler
‘사용 방법
Dim instance As FormEvents
Dim handler As VersionUpgradeEventHandler
AddHandler instance.VersionUpgrade, handler
public abstract event VersionUpgradeEventHandler VersionUpgrade
예외
| 예외 | 조건 |
|---|---|
| InvalidOperationException | 개발자가 InternalStartup 메서드가 아닌 다른 위치의 이벤트를 바인딩하려고 했습니다. |
주의
중요
VersionUpgrade 이벤트는 양식 코드에서 개발자가 인스턴스화하지 않습니다. Microsoft InfoPath 2010 디자인 모드 사용자 인터페이스에서 양식 수준 이벤트에 대해서만 이벤트 처리기를 추가해야 합니다. 디자인 모드 사용자 인터페이스에서 양식 서식 파일에 이벤트 처리기를 추가하면 InfoPath에서 EventManager 클래스와 FormEvents 클래스의 멤버로 양식 코드 파일의 InternalStartup 메서드에서 코드를 생성하여 이벤트를 해당 이벤트 처리기에 바인딩합니다. InfoPath 디자인 모드에서 이벤트 처리기를 추가하는 방법에 대한 자세한 내용은 방법: 이벤트 처리기 추가를 참조하십시오.
VersionUpgrade 이벤트에 대한 이벤트 처리기를 사용하면 양식을 마지막으로 연 이후에 기반으로 사용되는 양식 서식 파일이 업그레이드된 경우 양식을 업데이트하는 코드를 실행할 수 있습니다.
VersionUpgrade 이벤트는 VersionUpgradeEventHandler 대리자를 사용하여 바인딩됩니다.
VersionUpgrade 이벤트는 VersionUpgradeEventArgs 클래스의 CancelableArgs 속성을 사용하여 취소할 수 있습니다. Cancel 속성을 true로 설정하면 됩니다.
이 형식 또는 멤버는 Microsoft InfoPath Filer 또는 웹 브라우저에서 연 양식에서 실행되는 코드에서 액세스할 수 있습니다.
예
다음 예제에서는 VersionUpgradeEventArgs 클래스의 DocumentVersion 및 FormTemplateVersion 속성을 사용하여 양식 및 양식 서식 파일의 버전 번호를 표시합니다.
public void FormEvents_VersionUpgrade(object sender, VersionUpgradeEventArgs e)
{
MessageBox.Show("The form version: " + e.DocumentVersion +
"\nThe form template version: " + e.FormTemplateVersion);
// Write code to update form here.
}
Public Sub FormEvents_VersionUpgrade(ByVal sender As Object, _
ByVal e As VersionUpgradeEventArgs)
MessageBox.Show("The form version: " & e.DocumentVersion & _
vbNewLine & "The form template version: " & _
e.FormTemplateVersion)
' Write code to update form here.
End Sub