共用方式為

FormEvents.VersionUpgrade 事件

  • 發行項

發生於開啟的表單版本號碼比表單所依據的表單範本版本號碼還要舊時。

**命名空間：**Microsoft.Office.InfoPath
**組件：**Microsoft.Office.InfoPath (於 microsoft.office.infopath.dll 中)

語法

'宣告
Public 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 Office InfoPath 2007 設計模式使用者介面中為表單層級的事件新增事件處理常式。當您從設計模式使用者介面中將事件處理常式新增至您的表單範本時，InfoPath 會使用 EventManager 類別，在表單程式碼檔案的 InternalStartup 方法中產生程式碼，並且使用 FormEvents 類別的成員來將事件繫結至其事件處理常式。如需如何在 InfoPath 設計模式中新增事件處理常式的詳細資訊，請參閱操作方法：新增事件處理常式。

如果在上次開啟之後，表單所依據的表單範本已經升級，VersionUpgrade 事件的事件處理常式可以讓您執行程式碼，以便更新該表單。

VersionUpgrade 事件是使用 VersionUpgradeEventHandler 委派所繫結。

您可以使用 VersionUpgradeEventArgs 類別的 CancelableArgs 屬性，將 Cancel 屬性設定為 true，以便取消 VersionUpgrade 事件。

此類型或成員可以從 Microsoft Office InfoPath 2007 或 Web 瀏覽器所開啟表單中執行的程式碼存取。

範例

在下列範例中，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

請參閱

參考

FormEvents 類別
FormEvents 成員
Microsoft.Office.InfoPath 命名空間