Installer.OnBeforeInstall メソッド

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

Installer.OnBeforeInstall メソッド

BeforeInstall イベントを発生させます。

名前空間: System.Configuration.Install
アセンブリ: System.Configuration.Install (system.configuration.install.dll 内)
構文

Visual Basic (宣言)

Protected Overridable Sub
 OnBeforeInstall ( _
    savedState As IDictionary _
)

Visual Basic (使用法)

Dim savedState As IDictionary

Me.OnBeforeInstall(savedState)

C#

protected virtual void OnBeforeInstall (
    IDictionary savedState
)

C++

protected:
virtual void OnBeforeInstall (
    IDictionary^ savedState
)

J#

protected void OnBeforeInstall (
    IDictionary savedState
)

JScript

protected function OnBeforeInstall (
    savedState : IDictionary
)

パラメータ

savedState

Installers プロパティ内のインストーラがインストールされる前のコンピュータの状態を格納する IDictionary。この IDictionary オブジェクトは、この時点では空であることが必要です。

解説

このメソッドは、インスタンスの InstallerCollection 内にあるインストーラの Install メソッドが呼び出される前に呼び出されます。

イベントが発生すると、デリゲートを使用してイベント ハンドラが呼び出されます。詳細については、「イベントの発生」を参照してください。

OnBeforeInstall メソッドを使用すると、デリゲートを結び付けずに、派生クラスでイベントを処理することもできます。派生クラスでイベントを処理する場合は、この手法をお勧めします。

継承時の注意 派生クラスで OnBeforeInstall をオーバーライドする場合は、登録されているデリゲートがイベントを受け取ることができるように、基本クラスの OnBeforeInstall メソッドを呼び出してください。

使用例

OnBeforeInstall メソッドの例を次に示します。このメソッドは、派生クラスでオーバーライドされます。OnBeforeInstall メソッドには、インストールの前に実行する手順を追加するための領域が用意されています。

Visual Basic

' Override the 'OnBeforeInstall' method.
Protected Overrides Sub
 OnBeforeInstall(savedState As IDictionary)
   MyBase.OnBeforeInstall(savedState)
   ' Add steps to be done before the installation starts.
   Console.WriteLine("OnBeforeInstall method of MyInstaller called")
End Sub 'OnBeforeInstall

C#

// Override the 'OnBeforeInstall' method.
protected override void OnBeforeInstall(IDictionary
 savedState)
{
   base.OnBeforeInstall(savedState);
   // Add steps to be done before the installation starts.
   Console.WriteLine("OnBeforeInstall method of MyInstaller called");
}

C++

   // Override the 'OnBeforeInstall' method.
protected:
   virtual void OnBeforeInstall( IDictionary^ savedState ) override
   {
      Installer::OnBeforeInstall( savedState );
      
      // Add steps to be done before the installation starts.
      Console::WriteLine( "OnBeforeInstall method of MyInstaller called"
 );
   }

J#

// Override the 'OnBeforeInstall' method.
protected void OnBeforeInstall(IDictionary
 savedState)
{
    super.OnBeforeInstall(savedState);

    // Add steps to be done before the installation starts.
    Console.WriteLine("OnBeforeInstall method of MyInstaller called");
} //OnBeforeInstall

.NET Framework のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

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、1.1、1.0

参照

関連項目
Installer クラス
Installer メンバ
System.Configuration.Install 名前空間
OnAfterInstall
OnAfterRollback
OnAfterUninstall
OnCommitting
OnCommitted
OnBeforeRollback
OnBeforeUninstall