Installer.Install(IDictionary) Metoda

Reference

Definice

Obor názvů:: System.Configuration.Install

Sestavení:: System.Configuration.Install.dll

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

ArgumentException

Parametr stateSaver je null.

Exception

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 Install Installer 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.

Platí pro

Share via