Installer.Install(IDictionary) Methode

Definition

Führt beim Überschreiben in einer abgeleiteten Klasse die Installation aus.When overridden in a derived class, performs the installation.

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, in dem die zum Ausführen eines Commit-, Rollback- oder Deinstallationsvorgangs erforderlichen Daten gespeichert werden.An IDictionary used to save information needed to perform a commit, rollback, or uninstall operation.

Ausnahmen

Der stateSaver-Parameter ist null.The stateSaver parameter is null.

Im BeforeInstall-Ereignishandler eines der Installationsprogramme in der Auflistung ist eine Ausnahme aufgetreten.An exception occurred in the BeforeInstall event handler of one of the installers in the collection.

- oder --or- Im AfterInstall-Ereignishandler eines der Installationsprogramme in der Auflistung ist eine Ausnahme aufgetreten.An exception occurred in the AfterInstall event handler of one of the installers in the collection.

Beispiele

Im folgenden Beispiel wird die Install -Methode Installer der-Klasse veranschaulicht.The following example demonstrates the Install method of the Installer class. Eine-Klasse wird von der Installer -Basisklasse abgeleitet Install , und die-Methode wird überschrieben.A class is derived from the Installer base class and the Install method is overridden.

   // 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, stellen Sie sicher, dass Sie die Install(IDictionary) -Methode der Basisklasse zuerst in der abgeleiteten Methode aufruft.- If you override the Install(IDictionary) method in a derived class, be sure to call the base class's Install(IDictionary) method first in your derived method. Die Install(IDictionary) -Methode ruft Install(IDictionary) die-Methode jedes Installers auf, Installers das in der-Eigenschaft dieser Instanz enthalten ist.The Install(IDictionary) method calls the Install(IDictionary) method of each installer contained in the Installers property of this instance. Nachdem die enthaltenen Installationsprogramme ausgeführt wurden, aktualisiert diese IDictionary Methode das Objekt (das stateSaver durch den-Parameter angegeben wird), um den Status der Installation widerzuspiegeln.After the contained installers run, this method updates the IDictionary object (specified through the stateSaver parameter) to reflect the status of the installation. Der IDictionary muss leer sein, wenn er an Install(IDictionary) die-Methode übermittelt wird.The IDictionary should be empty when passed to the Install(IDictionary) method. Wenn alle Install(IDictionary) Methoden erfolgreich sind, wird Commit(IDictionary) die-Methode aufgerufen.If all the Install(IDictionary) methods succeed, the Commit(IDictionary) method is called. Andernfalls wird die Rollback(IDictionary) -Methode aufgerufen.Otherwise, the Rollback(IDictionary) method is called.

-Wenn Sie der Installers -Auflistung in der Install(IDictionary) -Methode Installationsprogramm Instanzen hinzufügen müssen, achten Sie darauf, dass Sie die gleichen Ergänzungen der Uninstall(IDictionary) -Auflistung in der-Methode ausführen.- If you need to add installer instances to the Installers collection in the Install(IDictionary) method, be sure to perform the same additions to the collection in the Uninstall(IDictionary) method. Sie können jedoch vermeiden, dass die Auflistung in beiden Methoden beibehalten wird, wenn Sie der Installers Auflistung im Klassenkonstruktor für das benutzerdefinierte Installationsprogramm Installations Instanzen hinzufügen.However, you can avoid maintaining the collection in both methods if you add installer instances to the Installers collection in the class constructor for your custom installer.

Gilt für:

Siehe auch