My.Application.Startup 事件

更新：2007 年 11 月

在应用程序启动时发生。

' 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 应用程序模型的一部分。有关更多信息，请参见 Visual Basic 应用程序模型概述。

可以使用 e 参数的 Cancel 属性来控制应用程序的启动窗体的加载。在 Cancel 属性设置为 True 时，启动窗体不会启动。在这种情况下，代码应调用备用的启动代码路径。例如，请参见如何：为 Window 窗体应用程序启用批处理模式。

可以使用 e 参数的 CommandLine 属性或 My.Application.CommandLineArgs 属性来访问应用程序的命令行参数。

Startup 事件处理程序的代码存储在 ApplicationEvents.vb 文件中，此文件默认情况下是隐藏的。

访问应用程序事件的“代码编辑器”窗口

1. 当“解决方案资源管理器”中有项目选中时，在“项目”菜单上单击“属性”。

2. 单击“应用程序”选项卡。

3. 单击“查看应用程序事件”按钮以打开代码编辑器。

有关更多信息，请参见如何：处理应用程序事件 (Visual Basic)。

任务

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

示例

本示例使用 My.Application.SplashScreen 属性和 My.Application.Startup 事件，在应用程序启动时用状态信息来更新初始屏幕。

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 运行库（在 Microsoft.VisualBasic.dll 中）

按项目类型列出的可用性

权限

可能需要下列权限：

有关更多信息，请参见代码访问安全性和请求权限。

请参见

任务

如何：为 Window 窗体应用程序启用批处理模式

如何：处理应用程序事件 (Visual Basic)

如何：指定应用程序的实例化行为 (Visual Basic)

概念

Visual Basic 应用程序模型概述

参考

My.Application 对象

My.Application.StartupNextInstance 事件

My.Application.CommandLineArgs 属性

Microsoft.VisualBasic.ApplicationServices.StartupEventArgs

WindowsFormsApplicationBase.Startup