Installer.Install(IDictionary) Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Configuration.Install

Zestaw:: System.Configuration.Install.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

W przypadku przesłonięcia w klasie pochodnej program wykonuje instalację.

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

Służy IDictionary do zapisywania informacji potrzebnych do wykonania operacji zatwierdzania, wycofywania lub odinstalowywania.

Wyjątki

ArgumentException

Parametr stateSaver to null.

Exception

Wystąpił wyjątek w BeforeInstall procedurze obsługi zdarzeń jednego z instalatorów w kolekcji.

-lub-

Wystąpił wyjątek w AfterInstall procedurze obsługi zdarzeń jednego z instalatorów w kolekcji.

Przykłady

W poniższym przykładzie pokazano metodę Install Installer klasy . Klasa pochodzi z klasy bazowej Installer , a Install metoda jest zastępowana.

   // 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

Uwagi dotyczące dziedziczenia

Jeśli zastąpisz metodę Install(IDictionary) w klasie pochodnej, najpierw wywołaj metodę klasy Install(IDictionary) bazowej w metodzie pochodnej. Metoda Install(IDictionary) wywołuje metodę Install(IDictionary) każdego instalatora zawartego we Installers właściwości tego wystąpienia. Po uruchomieniu zawartych instalatorów ta metoda aktualizuje IDictionary obiekt (określony za pomocą parametru stateSaver ) w celu odzwierciedlenia stanu instalacji. Element IDictionary powinien być pusty po przekazaniu do Install(IDictionary) metody . Jeśli wszystkie metody kończą się powodzeniem Install(IDictionary) , metoda jest wywoływana Commit(IDictionary) . W przeciwnym razie wywoływana Rollback(IDictionary) jest metoda .
Jeśli musisz dodać wystąpienia instalatora do kolekcji w Install(IDictionary) metodzie, pamiętaj, aby Installers wykonać te same dodatki do kolekcji w metodzie Uninstall(IDictionary) . Można jednak uniknąć obsługi kolekcji w obu metodach, jeśli dodasz wystąpienia instalatora do Installers kolekcji w konstruktorze klasy dla instalatora niestandardowego.

Dotyczy

Udostępnij za pośrednictwem