ServiceProcessInstaller.Rollback-Methode

Artikel
08/20/2007

Führt ein Rollback der Informationen über Dienstanwendungen durch, die bei der Installation in die Registrierung geschrieben wurden. Diese Methode ist nur für die Verwendung durch Installationstools vorgesehen, die die entsprechenden Methoden automatisch verarbeiten.

Namespace: System.ServiceProcess
Assembly: System.ServiceProcess (in system.serviceprocess.dll)

Syntax

'Declaration
Public Overrides Sub Rollback ( _
    savedState As IDictionary _
)
'Usage
Dim instance As ServiceProcessInstaller
Dim savedState As IDictionary

instance.Rollback(savedState)

public override void Rollback (
    IDictionary savedState
)

public:
virtual void Rollback (
    IDictionary^ savedState
) override

public void Rollback (
    IDictionary savedState
)

public override function Rollback (
    savedState : IDictionary
)

Parameter

savedState
Ein IDictionary mit Kontextinformationen für die Installation.

Ausnahmen

Ausnahmetyp	Bedingung
ArgumentException	Der savedState ist NULL (Nothing in Visual Basic). – oder – savedState ist beschädigt oder nicht vorhanden.

ArgumentException

Der savedState ist NULL (Nothing in Visual Basic).

– oder –

savedState ist beschädigt oder nicht vorhanden.

Hinweise

Normalerweise rufen Sie die Methoden für ServiceProcessInstaller nicht im Code auf. Diese werden i. d. R. nur vom Installationsdienstprogramm aufgerufen. Das Installationsdienstprogramm ruft bei der Installation automatisch die ServiceProcessInstaller.Install-Methode auf. Im Bedarfsfall werden Fehler behoben, indem Rollback für das Objekt aufgerufen wird, das die Ausnahme generiert hat.

Die Installationsroutine einer Anwendung verwaltet automatisch Informationen über bereits installierte Komponenten. Dazu wird der Installer.Context des Projektinstallationsprogramms verwendet. Diese Zustandsinformationen, die als savedState-Parameter an Rollback übergeben werden, werden fortlaufend aktualisiert, während das Dienstprogramm die ServiceProcessInstaller-Instanz und alle ServiceInstaller-Instanzen installiert. Normalerweise ist es nicht erforderlich, dass der Code diese Zustandsinformationen explizit ändert.

Rollback übergibt alle Ausnahmen, die von Basisklassenmethoden oder BeforeInstall-Ereignishandlern und AfterInstall-Ereignishandlern ausgelöst werden, an die aufrufende Methode.

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

ServiceProcessInstaller-Klasse
ServiceProcessInstaller-Member
System.ServiceProcess-Namespace
Install
ComponentInstaller

Freigeben über