Installer.Uninstall(IDictionary) Methode

Definition

Namespace:
System.Configuration.Install
Assembly:
System.Configuration.Install.dll

Wenn eine abgeleitete Klasse außer Kraft gesetzt wird, wird eine Installation entfernt.

public:
 virtual void Uninstall(System::Collections::IDictionary ^ savedState);
public virtual void Uninstall(System.Collections.IDictionary savedState);
abstract member Uninstall : System.Collections.IDictionary -> unit
override this.Uninstall : System.Collections.IDictionary -> unit
Public Overridable Sub Uninstall (savedState As IDictionary)

Parameter

savedState
IDictionary

Ein IDictionary Element, das den Status des Computers enthält, nachdem die Installation abgeschlossen war.

Ausnahmen

ArgumentException

Möglicherweise ist der gespeicherte Zustand IDictionary beschädigt.

InstallException

Ausnahme beim Deinstallieren. Diese Ausnahme wird ignoriert, und die Deinstallation wird fortgesetzt. Die Anwendung wird jedoch nach Abschluss der Deinstallation möglicherweise nicht vollständig deinstalliert.

Beispiele

Das folgende Beispiel veranschaulicht die Uninstall Methode von Installer. Die Uninstall Methode wird in der abgeleiteten Klasse von Installerüberschrieben.

   // Override 'Uninstall' method of Installer class.
public:
   virtual void Uninstall( IDictionary^ mySavedState ) override
   {
      if ( mySavedState == nullptr )
      {
         Console::WriteLine( "Uninstallation Error !" );
      }
      else
      {
         Installer::Uninstall( mySavedState );
         Console::WriteLine( "The Uninstall method of 'MyInstallerSample' has been called" );
      }
   }

// Override 'Uninstall' method of Installer class.
public override void Uninstall( IDictionary mySavedState )
{
   if (mySavedState == null)
   {
      Console.WriteLine("Uninstallation Error !");
   }
   else
   {
      base.Uninstall( mySavedState );
      Console.WriteLine( "The Uninstall method of 'MyInstallerSample' has been called" );
   }
}

' Override 'Uninstall' method of Installer class.
Public Overrides Sub Uninstall(mySavedState As IDictionary)
   If mySavedState Is Nothing Then
      Console.WriteLine("Uninstallation Error !")
   Else
      MyBase.Uninstall(mySavedState)
      Console.WriteLine("The Uninstall method of 'MyInstallerSample' has been called")
   End If
End Sub

Hinweise für Vererber

  • Wenn Sie die Install(IDictionary) Methode in einer abgeleiteten Klasse überschreiben, müssen Sie die Methode der Basisklasse Install(IDictionary) zuerst in der abgeleiteten Methode aufrufen. Die Install(IDictionary) Methode ruft die Install(IDictionary) Methode der einzelnen Installationsprogramme auf, die in der Installers Eigenschaft dieser Instanz enthalten sind. Nachdem die enthaltenen Installationsprogramme ausgeführt wurden, aktualisiert diese Methode das IDictionary Objekt (durch den stateSaver Parameter angegeben), um den Status der Installation widerzuspiegeln. Dies 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 Installationsinstanzen hinzufügen müssen, müssen Sie die gleichen Ergänzungen zur Auflistung in der Uninstall(IDictionary) Methode ausführen. Sie können jedoch vermeiden, die Auflistung in beiden Methoden beizubehalten, wenn Sie der Installers Auflistung im Klassenkonstruktor für das benutzerdefinierte Installationsprogramm Installationsinstanzen hinzufügen.

Gilt für:

Weitere Informationen