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 -> unit
Public Overridable Sub Install (stateSaver As IDictionary)
參數
- stateSaver
- IDictionary
IDictionary,用來儲存執行認可、復原或解除安裝作業所需的資訊。
例外狀況
stateSaver
參數為 null
。
範例
下列範例示範 Install 類別的 Installer 方法。 類別衍生自 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 自定義安裝程式類別建構函式中的集合,則可以避免在這兩種方法中維護集合。