Installer.Install メソッドとは何？わかりやすく解説 Weblio辞書

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

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

Installer.Install メソッド

派生クラスによってオーバーライドされた場合、インストールを実行します。

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

Visual Basic (宣言)

Public Overridable Sub Install
 ( _
    stateSaver As IDictionary _
)

Visual Basic (使用法)

Dim instance As Installer
Dim stateSaver As IDictionary

instance.Install(stateSaver)

public virtual void Install (
    IDictionary stateSaver
)

C++

public:
virtual void Install (
    IDictionary^ stateSaver
)

public void Install (
    IDictionary stateSaver
)

JScript

public function Install (
    stateSaver : IDictionary
)

パラメータ

stateSaver: コミット、ロールバック、またはアンインストール操作を実行するために必要な情報を保存するために使用する IDictionary。

例外

例外の種類	条件
ArgumentException	stateSaver パラメータが null 参照 (Visual Basic では Nothing) です。
Exception	コレクション内にあるインストーラのうちの 1 つのインストーラの BeforeInstall イベントハンドラで例外が発生しました。またはコレクション内にあるインストーラのうちの 1 つのインストーラの AfterInstall イベントハンドラで例外が発生しました。

例外の種類

条件

ArgumentException

stateSaver パラメータが null 参照 (Visual Basic では Nothing) です。

Exception

コレクション内にあるインストーラのうちの 1 つのインストーラの BeforeInstall イベントハンドラで例外が発生しました。

または

コレクション内にあるインストーラのうちの 1 つのインストーラの AfterInstall イベントハンドラで例外が発生しました。

解説

継承時の注意 派生クラスで Install メソッドをオーバーライドする場合は、派生メソッド内で、まず基本クラスの Install メソッドを呼び出してください。Install メソッドは、インスタンスの Installers プロパティに格納されている各インストーラの Install メソッドを呼び出します。インスタンスが格納している各インストーラが実行された後、このメソッドは、stateSaver パラメータで指定されている IDictionary オブジェクトを更新し、インストールのステータスを反映させます。IDictionary は、Install メソッドに渡すときは空の状態であることが必要です。すべての Install メソッドが成功すると、Commit メソッドが呼び出されます。それ以外の場合は、Rollback メソッドが呼び出されます。

使用例

Installer クラスの Install メソッドの例を次に示します。Installer 基本クラスからクラスが派生され、Install メソッドがオーバーライドされます。

Visual Basic

' Override the 'Install' method of the Installer class.
Public Overrides Sub Install(mySavedState
 As IDictionary)
   MyBase.Install(mySavedState)
   ' Code maybe written for installation of an application.
   Console.WriteLine("The Install method of 'MyInstallerSample'
 has been called")
End Sub 'Install

// Override the 'Install' method of the Installer class.
public override void Install( IDictionary mySavedState
 )
{
   base.Install( mySavedState );
   // Code maybe written for installation of an application.
   Console.WriteLine( "The Install method of 'MyInstallerSample' has been called"
 );
}

C++

   // Override the 'Install' method of the Installer class.
public:
   virtual void Install( IDictionary^ mySavedState ) override
   {
      Installer::Install( mySavedState );
      // Code maybe written for installation of an application.
      Console::WriteLine( "The Install method of 'MyInstallerSample' has been
 called" );
   }

// Override the 'Install' method of the Installer class.
public void Install(IDictionary mySavedState)
{
    super.Install(mySavedState);

    // Code maybe written for installation of an application.
    Console.WriteLine("The Install method of"
        +" 'MyInstallerSample' has been called");
} //Install