Installer.Uninstall-Methode

Artikel
08/20/2007

Entfernt beim Überschreiben in einer abgeleiteten Klasse eine Installation.

Namespace: System.Configuration.Install
Assembly: System.Configuration.Install (in system.configuration.install.dll)

Syntax

'Declaration
Public Overridable Sub Uninstall ( _
    savedState As IDictionary _
)
'Usage
Dim instance As Installer
Dim savedState As IDictionary

instance.Uninstall(savedState)

public virtual void Uninstall (
    IDictionary savedState
)

public:
virtual void Uninstall (
    IDictionary^ savedState
)

public void Uninstall (
    IDictionary savedState
)

public function Uninstall (
    savedState : IDictionary
)

Parameter

savedState
Ein IDictionary mit Informationen über den Zustand, in dem sich der Computer nach Abschluss der Installation befindet.

Ausnahmen

Ausnahmetyp	Bedingung
ArgumentException	Das IDictionary mit dem gespeicherten Zustand ist möglicherweise beschädigt.
InstallException	Während der Deinstallation ist eine Ausnahme aufgetreten. Diese Ausnahme wird ignoriert, und die Deinstallation wird fortgesetzt. Nach Abschluss der Deinstallation wurde die Anwendung jedoch möglicherweise nicht vollständig deinstalliert.

Hinweise

Hinweise für Erben Wenn Sie die Uninstall-Methode in einer abgeleiteten Klasse überschreiben, müssen Sie in der abgeleiteten Methode unbedingt zuerst die Uninstall-Methode der Basisklasse aufrufen. Die Uninstall-Methode wird aufgerufen, um eine vorher abgeschlossene Installation zu entfernen. Wenn die Deinstallation für ein Installationsprogramm in der Auflistung fehlschlägt, wird die Deinstallation für die anderen Installationsprogramme trotzdem fortgesetzt. Bei einer fehlgeschlagenen Deinstallation wird der Computer nicht in den Zustand zurückversetzt, in dem er sich vor der Deinstallation befand. Der Zustand, in dem sich der Computer nach den Installationen befindet, wird zwar von der Install-Methode und der Commit-Methode gespeichert. Die Datei, die das IDictionary aus dem savedState-Parameter enthält, wurde jedoch möglicherweise nach Abschluss der Installation gelöscht. Wenn die Datei gelöscht wurde, ist der savedState-Parameter NULL (Nothing in Visual Basic). Die Uninstall-Methode muss in der Lage sein, einen NULL (Nothing in Visual Basic)savedState-Parameter zu behandeln.

Beispiel

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 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 'Uninstall

// 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:
   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 void Uninstall(IDictionary mySavedState)
{
    if (mySavedState.Equals(null)) {
        Console.WriteLine("Uninstallation Error !");
    }
    else {
        super.Uninstall(mySavedState);
        Console.WriteLine("The Uninstall method of 'MyInstallerSample'"
            +" has been called");
    }
} //Uninstall

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter .

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

Installer-Klasse
Installer-Member
System.Configuration.Install-Namespace
Install
Commit
Rollback
InstallerCollection
Installers

Freigeben über