Installer.Install(IDictionary) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
派生クラスによってオーバーライドされた場合、インストールを実行します。
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 -> unitPublic Overridable Sub Install (stateSaver As IDictionary)パラメーター
- stateSaver
- IDictionary
IDictionaryは、コミット、ロールバック、またはアンインストール操作を実行するために必要な情報を保存するために使用されます。
例外
stateSaver パラメーターが null です。
コレクション内にあるインストーラーのうちの 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 を追加する場合は、両方のメソッドでコレクションを維持しないようにすることができます。
適用対象
こちらもご覧ください
.NET