My.Application.Startup 事件

项目
08/18/2008

更新：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 文件中，此文件默认情况下是隐藏的。

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

当“解决方案资源管理器”中有项目选中时，在“项目”菜单上单击“属性”。
单击“应用程序”选项卡。
单击“查看应用程序事件”按钮以打开代码编辑器。

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

任务

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

要执行的操作	请参见
使用 Visual Basic 应用程序模型提供的事件来运行代码	如何：在应用程序启动或结束时运行代码
检查应用程序在启动时是否使用了字符串 /batch 作为参数	如何：为 Window 窗体应用程序启用批处理模式

示例

本示例使用 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 中）

按项目类型列出的可用性

项目类型	是否可用
Windows 应用程序	是
类库	否
控制台应用程序	否
Windows 控件库	否
Web 控件库	否
Windows 服务	否
网站	否

权限

可能需要下列权限：

权限	说明
SecurityPermission	控制为此事件添加事件处理程序的能力。关联的枚举：SecurityPermissionFlag.ControlAppDomain。

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

请参见

通过

My.Application.Startup 事件

参数

备注

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

任务

示例

要求

按项目类型列出的可用性

权限

请参见

任务

概念

参考

其他资源