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。

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