Installer.Install メソッド

  • [アーティクル]

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

Public Overridable Sub Install( _
   ByVal stateSaver As IDictionary _)
[C#]
public virtual void Install(IDictionarystateSaver);
[C++]
public: virtual void Install(IDictionary* stateSaver);
[JScript]
public function Install(
   stateSaver : IDictionary);

パラメータ

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

例外

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

または

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

解説

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

使用例

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

 
' 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

[C#] 
// 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.
void Install(IDictionary* mySavedState) {
    Installer::Install(mySavedState);
    // Code maybe written for installation of an application.
    Console::WriteLine(S"The Install method of 'MyInstallerSample' has been called");
}

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン 言語のフィルタ をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

.NET Framework セキュリティ:

参照

Installer クラス | Installer メンバ | System.Configuration.Install 名前空間 | Commit | IDictionary | InstallerCollection | Installers | Rollback | Uninstall