Installer.Install(IDictionary) Methode

Referenz

Definition

Namespace:: System.Configuration.Install

Assembly:: System.Configuration.Install.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

ArgumentException

Der stateSaver-Parameter ist null.

Exception

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 Installers Install(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: