Installer.Install(IDictionary) メソッド

  • リファレンス

定義

名前空間:
System.Configuration.Install
アセンブリ:
System.Configuration.Install.dll

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

public:
 virtual void Install(System::Collections::IDictionary ^ stateSaver);
public virtual void Install (System.Collections.IDictionary stateSaver);
abstract member Install : System.Collections.IDictionary -> unit
override this.Install : System.Collections.IDictionary -> unit
Public Overridable Sub Install (stateSaver As IDictionary)

パラメーター

stateSaver
IDictionary

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

例外

ArgumentException

stateSaver パラメーターが null です。

Exception

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

- または -

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

例

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

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

' 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(IDictionary) オーバーライドする場合は、必ず派生メソッドで最初に基底クラスの Install(IDictionary) メソッドを呼び出してください。 メソッドは Install(IDictionary) 、 Install(IDictionary) このインスタンスの プロパティに含まれる各インストーラーの メソッドを Installers 呼び出します。 包含インストーラーを実行した後、このメソッドは、インストールの状態を IDictionary 反映するように (パラメーターで stateSaver 指定された) オブジェクトを更新します。 IDictionaryメソッドに渡す場合は、 を空にするInstall(IDictionary)必要があります。 すべてのメソッドが Install(IDictionary) 成功すると、 Commit(IDictionary) メソッドが呼び出されます。 それ以外の場合は、 メソッドが Rollback(IDictionary) 呼び出されます。

  • メソッドのコレクションにインストーラー インスタンスを追加する Installers 必要がある場合は、 メソッド内の Install(IDictionary) コレクション Uninstall(IDictionary) に対して同じ追加を実行してください。 ただし、カスタム インストーラーのクラス コンストラクター内のコレクションにインストーラー インスタンス Installers を追加する場合は、両方のメソッドでコレクションを維持しないようにすることができます。

適用対象

こちらもご覧ください