Installer.Install(IDictionary) Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Při přepsání v odvozené třídě provede instalaci.
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)
Parametry
- stateSaver
- IDictionary
Slouží IDictionary k uložení informací potřebných k provedení operace potvrzení, vrácení zpět nebo odinstalace.
Výjimky
Parametr stateSaver
je null
.
Došlo k výjimce v obslužné rutině BeforeInstall události jednoho z instalačních programů v kolekci.
-nebo-
Došlo k výjimce v obslužné rutině AfterInstall události jednoho z instalačních programů v kolekci.
Příklady
Následující příklad ukazuje metodu InstallInstaller třídy . Třída je odvozena ze Installer základní třídy a Install metoda je přepsána.
// 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
Poznámky pro dědice
Pokud přepíšete metodu Install(IDictionary) v odvozené třídě, nezapomeňte nejprve volat metodu základní třídy Install(IDictionary) v odvozené metodě. Metoda Install(IDictionary) volá metodu Install(IDictionary) každého instalačního programu obsaženého Installers ve vlastnosti této instance. Po spuštění instalačních programů s omezením tato metoda aktualizuje IDictionary objekt (zadaný prostřednictvím parametru
stateSaver
) tak, aby odrážel stav instalace. Při IDictionary předání do Install(IDictionary) metody by měl být prázdný. Pokud jsou Install(IDictionary) všechny metody úspěšné, zavolá se Commit(IDictionary) metoda . V opačném Rollback(IDictionary) případě je volána metoda .Pokud potřebujete přidat instance instalačního Installers programu do kolekce v Install(IDictionary) metodě , nezapomeňte provést stejné dodatky do kolekce v Uninstall(IDictionary) metodě . Pokud však přidáte instance instalačního programu do Installers kolekce v konstruktoru třídy pro vlastní instalační program, můžete se vyhnout údržbě kolekce v obou metodách.