WindowsFormsApplicationBase.Startup イベント

.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

C#

public event StartupEventHandler Startup

C++

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

J#

/** @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

この例は、SplashScreen1 という名前のスプラッシュ スクリーンがプロジェクトに配置されていることを前提としています。スプラッシュ スクリーンには、ユーザー インターフェイスを更新するための、Status というプロパティを割り当てておきます。

このコードは、アプリケーション イベントのコード エディタ ウィンドウで入力する必要があります。このウィンドウにアクセスする手順については、このトピックの「解説」を参照してください。詳細については、「方法 : アプリケーション イベントを処理する (Visual Basic)」を参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
WindowsFormsApplicationBase クラス
WindowsFormsApplicationBase メンバ
Microsoft.VisualBasic.ApplicationServices 名前空間
StartupEventArgs クラス
WindowsFormsApplicationBase.Startup イベント
その他の技術情報
My.Application.Startup イベント
My.Application オブジェクト
My.Application.StartupNextInstance イベント
方法 : Windows フォーム アプリケーションのバッチ モードを有効にする
My.Application.CommandLineArgs プロパティ
方法 : アプリケーション イベントを処理する (Visual Basic)
方法 : アプリケーションのインスタンス化の動作を指定する
Visual Basic アプリケーション モデルの概要