Installer.Install メソッド

.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)

C#

public virtual void Install (
    IDictionary stateSaver
)

C++

public:
virtual void Install (
    IDictionary^ stateSaver
)

J#

public 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 メソッドが呼び出されます。

使用例

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

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.
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" );
   }

J#

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

.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 名前空間
Commit
IDictionary
InstallerCollection
Installers
Rollback
Uninstall