My.Application.Startup 事件

My.Application.Startup 事件

 

在應用程序啓動時發生。

' Usage
Public Sub Me_Startup( _
   ByVal sender As Object, _
   ByVal e As StartupEventArgs _
) Handles Me.Startup
End Sub
' Declaration
Public Event Startup( _
   ByVal sender As Object, _
   ByVal e As StartupEventArgs _
)

 

參數

sender

引發該事件的 Object。

e

StartupEventArgs 對象，包含了應用程序的命令行參數。

 備註

普通（非單實例）的應用程序在每次啓動時會引發 Startup 事件。對於單實例的應用程序，只有在它尚未處於活動狀態的情況下啓動時纔會引發 Startup 事件；否則，它將引發 StartupNextInstance 事件。有關更多信息，請參見 My.Application.StartupNextInstance 事件和如何：指定應用程序的實例化行爲。

此事件是 Visual Basic 應用程序模型的一部分。有關更多信息，請參見 Visual Basic 應用程序模型概述。

可以使用 e 參數的 Cancel 屬性來控制應用程序的啓動窗體的加載。在 Cancel 屬性設置爲 True 時，啓動窗體不會啓動。在這種情況下，代碼應調用備用的啓動代碼路徑。例如，請參見如何：爲 Window 窗體應用程序啓用批處理模式。

可以使用 e 參數的 CommandLine 屬性或 My.Application.CommandLineArgs 屬性來訪問應用程序的命令行參數。

Startup 事件處理程序的代碼存儲在 ApplicationEvents.vb 文件中，此文件默認情況下是隱藏的。

訪問應用程序事件的“代碼編輯器”窗口

1. 當“解決方案資源管理器”中有項目選中時，在“項目”菜單上單擊“屬性”。

2. 單擊“應用程序”選項卡。

3. 單擊“查看應用程序事件”按鈕以打開代碼編輯器。

有關更多信息，請參見如何：處理應用程序事件 (Visual Basic)。

 任務

下表列出了涉及 My.Application.Startup 事件的任務的示例。

要執行的操作	請參見
使用 Visual Basic 應用程序模型提供的事件來運行代碼	如何：在應用程序啓動或結束時運行代碼
檢查應用程序在啓動時是否使用了字符串 /batch 作爲參數	如何：爲 Window 窗體應用程序啓用批處理模式

 示例

本示例使用 My.Application.SplashScreen 屬性和 My.Application.Startup 事件，在應用程序啓動時用狀態信息來更新初始屏幕。

Visual Basic

複製代碼

Private Sub MyApplication_Startup( _
    ByVal sender As Object, _
    ByVal e As Microsoft.VisualBasic.ApplicationServices.StartupEventArgs _
) Handles Me.Startup
    ' Get the splash screen.
    Dim splash As SplashScreen1 = CType(My.Application.SplashScreen, SplashScreen1)
    ' Display current status information.
    splash.Status = "Current user: " & My.User.Name
End Sub

本示例要求項目具有一個名爲 SplashScreen1 的初始屏幕。此初始屏幕需要具有更新其用戶界面的名爲 Status 的屬性。

必須在“代碼編輯器”窗口中輸入應用程序事件的代碼。要訪問此窗口，請按照本主題的“備註”部分中的說明進行。有關更多信息，請參見如何：處理應用程序事件 (Visual Basic)。

 要求

命名空間： Microsoft.VisualBasic.ApplicationServices

類： WindowsFormsApplicationBase

程序集： Visual Basic Runtime Library（在 Microsoft.VisualBasic.dll 中）

按項目類型列出的可用性

項目類型	是否可用
Windows 應用程序	是
類庫	否
控制檯應用程序	否
Windows 控件庫	否
Web 控件庫	否
Windows 服務	否
網站	否

 權限

可能需要下列權限：

權限	說明
SecurityPermission	控制爲此事件添加事件處理程序的能力。關聯的枚舉：System.Security.Permissions.SecurityPermissionFlag.ControlAppDomain。

有關更多信息，請參見代碼訪問安全性和請求權限。