WindowsFormsApplicationBase.Startup イベントとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

WindowsFormsApplicationBase.Startup イベント

メモ : このイベントは、.NET Framework version 2.0 で新しく追加されたものです。

アプリケーションの起動時に発生します。

名前空間: Microsoft.VisualBasic.ApplicationServices
アセンブリ: Microsoft.VisualBasic (microsoft.visualbasic.dll 内)
構文

Visual Basic (宣言)

Public Event Startup As
 StartupEventHandler

Visual Basic (使用法)

Dim instance As WindowsFormsApplicationBase
Dim handler As StartupEventHandler

AddHandler instance.Startup, handler

public event StartupEventHandler Startup

C++

public:
event StartupEventHandler^ Startup {
    void add (StartupEventHandler^ obj);
    void remove (StartupEventHandler^ obj);
}

/** @event */
public void add_Startup (StartupEventHandler
 obj)

/** @event */
public void remove_Startup (StartupEventHandler
 obj)

JScript

JScript では、イベントは使用できますが、新規に宣言することはできません。

解説

詳細については、Visual Basic のトピック「My.Application.Startup イベント」を参照してください。

通常の (単一インスタンスではない) アプリケーションの場合、Startup イベントは、アプリケーションを起動するたびに発生します。単一インスタンスのアプリケーションでは、そのアプリケーションがまだアクティブになっていない場合に限り、起動時に Startup イベントが発生します。それ以外の場合は、StartupNextInstance イベントが発生します。詳細については、My.Application.StartupNextInstance イベント、方法 : アプリケーションのインスタンス化の動作を指定するの各トピックを参照してください。

このイベントは、Visual Basic アプリケーションモデルに属する機能です。詳細については、「Visual Basic アプリケーションモデルの概要」を参照してください。

e パラメータの Cancel プロパティを使用すると、アプリケーションのスタートアップフォームの読み込みを制御できます。Cancel プロパティを True に設定した場合、スタートアップフォームは起動されません。この場合、別のスタートアップコードパスを呼び出すコードを記述する必要があります。例については、「方法 : Windows フォームアプリケーションのバッチモードを有効にする」を参照してください。

e パラメータの CommandLine プロパティまたは My.Application.CommandLineArgs プロパティを使用すると、アプリケーションのコマンドライン引数にアクセスできます。

Startup イベントハンドラのコードは、ApplicationEvents.vb ファイル (既定では隠しファイル) に格納されています。

アプリケーションイベントのコードエディタウィンドウにアクセスするには

ソリューションエクスプローラでプロジェクトを選択し、[プロジェクト] メニューの [プロパティ] をクリックします。

[アプリケーション] タブをクリックします。

[アプリケーションイベントの表示] をクリックして、コードエディタを開きます。

詳細については、「方法 : アプリケーションイベントを処理する (Visual Basic)」を参照してください。

My.Application.Startup イベントを使ったタスクの例を次の表に示します。

目的	参照項目
Visual Basic アプリケーションモデルのイベントを利用してコードを実行する。	方法 : アプリケーションの起動時または終了時にコードを実行する
アプリケーションの起動時に、引数として文字列 `/batch` が渡されたかどうかをチェックする。	方法 : Windows フォームアプリケーションのバッチモードを有効にする

使用例

この例では、My.Application.SplashScreen プロパティおよび My.Application.Startup イベントを使用し、アプリケーションの起動時に、スプラッシュスクリーンをステータス情報で更新しています。

Visual Basic

Private Sub MyApplication_Shutdown( _
    ByVal sender As Object,
 _
    ByVal e As System.EventArgs _
) Handles Me.Shutdown
    My.Application.Log.WriteEntry("Application Shut Down.")
End Sub