擴充 Visual Basic 應用程式模型

更新：2007 年 11 月

您可以為應用程式模型加入一些功能，其方式是覆寫 WindowsFormsApplicationBase 類別的 Overridable 成員。這個方法可讓您在應用程式啟動和關閉時，自訂應用程式模型的行為，並為您自己的方法加入呼叫。

應用程式模型的視覺化概觀

這一節會在 Visual Basic 應用程式模型中以視覺化方式呈現函式呼叫的順序，下一節則會詳述每一個函式的用途。

下圖將顯示一般 Visual Basic Windows Form 應用程式中的應用程式模型呼叫順序。當 Sub Main 程序呼叫 Run 方法時，即會啟動此順序。

Visual Basic 應用程式模型也提供了 StartupNextInstance 和 UnhandledException 事件。下圖將顯示引發這些事件的機制。

覆寫基底方法

My.Application.Run 方法會定義 Application 方法執行的順序。根據預設，Windows Form 應用程式的 Sub Main 程序會呼叫 Run 方法。

如果應用程式是標準的應用程式 (多個執行個體的應用程式) 或是單一執行個體應用程式的第一個執行個體，則 Run 方法會以下列順序執行 Overridable 方法：

1. OnInitialize：根據預設，此方法會設定視覺化樣式、文字顯示樣式和主應用程式執行緒的目前主體 (如果應用程式使用 Windows 驗證)，如果未使用 /nosplash 和 -nosplash 做為命令列引數，還會呼叫 ShowSplashScreen。

   如果此函式會傳回 False，則表示應用程式啟動順序已取消。如果有不應該執行應用程式的情況，此功能會很有用。

   OnInitialize 方法會呼叫下列方法：

   1. ShowSplashScreen：判斷應用程式是否有定義啟動顯示畫面，如果有，會在不同執行緒上顯示啟動顯示畫面。

      ShowSplashScreen 方法所包含的程式碼，會將啟動顯示畫面至少顯示 MinimumSplashScreenDisplayTime 屬性所指定的毫秒數。若要使用此功能，您必須使用 [專案設計工具] 將啟動顯示畫面加入至應用程式 (並將 My.Application.MinimumSplashScreenDisplayTime 屬性設定為兩秒)，或採用某種方法設定 My.Application.MinimumSplashScreenDisplayTime 屬性，以便覆寫 OnInitialize 或 OnCreateSplashScreen 方法。如需詳細資訊，請參閱 My.Application.MinimumSplashScreenDisplayTime 屬性。

   2. OnCreateSplashScreen：允許設計工具發出用於初始化啟動顯示畫面的程式碼。

      根據預設，此方法不會執行任何動作。如果您在 Visual Basic [專案設計工具] 中選取應用程式的啟動顯示畫面，則設計工具會採用將 SplashScreen 屬性設為啟動顯示畫面表單之新執行個體的方法，覆寫 OnCreateSplashScreen 方法。

2. OnStartup：提供能引發 Startup 事件的擴充性項目。如果此函式傳回 False，則應用程式啟動順序就會停止。

   根據預設，此方法會引發 Startup 事件。如果事件處理常式將事件引數的 Cancel 屬性設定為 True，則方法會傳回 False，以取消應用程式啟動。

3. OnRun：提供完成初始化後，主應用程式準備好可以開始執行的起點。

   根據預設，在它進入 Windows Forms 訊息迴圈之前，此方法會呼叫 OnCreateMainForm 方法 (以建立應用程式的主要表單) 和 HideSplashScreen 方法 (以關閉啟動顯示畫面)：

   1. OnCreateMainForm：提供設計工具發出用於初始化主要表單之程式碼的方法。

      根據預設，此方法不會執行任何動作。但是，當您在 Visual Basic [專案設計工具] 中選取應用程式的主要表單時，設計工具會採用將 MainForm 屬性設定為主要表單之新執行個體的方法，覆寫 OnCreateMainForm 方法。

   2. HideSplashScreen：如果應用程式已定義並開啟啟動顯示畫面，則此方法會關閉啟動顯示畫面。

      根據預設，此方法會關閉啟動顯示畫面。

4. OnStartupNextInstance：當單一執行個體應用程式已啟動一個執行個體時，可以自訂此應用程式的行為方式。

   根據預設，此方法會引發 StartupNextInstance 事件。

5. OnShutdown：提供能引發 Shutdown 事件的擴充性項目。如果主應用程式中發生未處理的例外狀況，則不會執行此方法。

   根據預設，此方法會引發 Shutdown 事件。

6. OnUnhandledException：如果以上列出的任何方法中發生未處理的例外狀況，便會執行此方法。

   根據預設，只要未附加偵錯工具，而且應用程式正在處理 UnhandledException 事件，此方法就會引發 UnhandledException 事件。

如果應用程式是單一執行個體應用程式，並已開始執行，則後續的應用程式執行個體會呼叫原始應用程式執行個體上的 OnStartupNextInstance 方法，然後結束。

WindowsFormsApplicationBase 建構函式會呼叫 UseCompatibleTextRendering 屬性，以判斷要將哪一個文字呈現引擎用於應用程式的表單。根據預設，UseCompatibleTextRendering 屬性會傳回 False，表示應該要使用 GDI 文字呈現引擎 (這是 Visual Basic 2005 中的預設值)。您可以覆寫 UseCompatibleTextRendering 屬性來傳回 True，表示應該要使用 GDI+ 文字呈現引擎 (這是 Visual Basic .NET 2002 和 Visual Basic .NET 2003 中的預設值)。

設定應用程式

WindowsFormsApplicationBase 類別是 Visual Basic 應用程式模型的一部分，會提供用於設定應用程式的保護 (Protected) 屬性。這些屬性應該在實作類別的建構函式 (Constructor) 中加以設定。

在預設的 Windows Form 專案中，[專案設計工具] 會建立程式碼，並利用設計工具的設定，進行屬性的設定。這些屬性只有在啟動應用程式時才會用到，在應用程式啟動之後設定屬性則不會有任何作用。

請參閱

概念

Visual Basic 應用程式模型概觀

參考

My.Application 物件

My.Application.Startup 事件

My.Application.StartupNextInstance 事件

My.Application.UnhandledException 事件

My.Application.Shutdown 事件

My.Application.NetworkAvailabilityChanged 事件

WindowsFormsApplicationBase