Freigeben über


Installer.Install(IDictionary) Methode

Definition

Führt beim Überschreiben in einer abgeleiteten Klasse die Installation aus.

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)

Parameter

stateSaver
IDictionary

Ein IDictionary-Objekt, in dem die zum Ausführen eines Commit-, Rollback- oder Deinstallationsvorgangs erforderlichen Daten gespeichert werden.

Ausnahmen

Der stateSaver-Parameter ist null.

Im BeforeInstall-Ereignishandler eines der Installationsprogramme in der Auflistung ist eine Ausnahme aufgetreten.

- oder -

Im AfterInstall-Ereignishandler eines der Installationsprogramme in der Auflistung ist eine Ausnahme aufgetreten.

Beispiele

Im folgenden Beispiel wird die Install -Methode der Installer -Klasse veranschaulicht. Eine Klasse wird von der Installer Basisklasse abgeleitet, und die Install -Methode wird überschrieben.

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

Hinweise für Vererber

  • Wenn Sie die Install(IDictionary) Methode in einer abgeleiteten Klasse überschreiben, müssen Sie zuerst die Methode der Basisklasse Install(IDictionary) in Ihrer abgeleiteten Methode aufrufen. Die Install(IDictionary) -Methode ruft die Install(IDictionary) -Methode jedes Installationsprogramms auf, das in der Installers Eigenschaft dieses instance enthalten ist. Nachdem die enthaltenen Installationsprogramme ausgeführt wurden, aktualisiert diese Methode das IDictionary -Objekt (angegeben über den stateSaver -Parameter), um die status der Installation widerzuspiegeln. Die IDictionary sollte leer sein, wenn sie an die Install(IDictionary) -Methode übergeben wird. Wenn alle Install(IDictionary) Methoden erfolgreich sind, wird die Commit(IDictionary) -Methode aufgerufen. Andernfalls wird die Rollback(IDictionary) -Methode aufgerufen.

  • Wenn Sie der Auflistung in der InstallersInstall(IDictionary) -Methode Installerinstanzen hinzufügen müssen, stellen Sie sicher, dass Sie die gleichen Ergänzungen zur Auflistung in der Uninstall(IDictionary) -Methode ausführen. Sie können jedoch vermeiden, dass die Auflistung in beiden Methoden beibehalten wird, wenn Sie der Installers Auflistung im Klassenkonstruktor für Ihr benutzerdefiniertes Installationsprogramm Installer-Instanzen hinzufügen.

Gilt für:

Weitere Informationen