Freigeben über


Speichern von Statusinformationen im Installationsprozess

Aktualisiert: November 2007

Bei der Installation von Komponenten schreibt die Installer-Klasse (oder eine andere Klasse, deren RunInstallerAttribute-Wert auf true festgelegt ist) eine Datei mit der Erweiterung .InstallState auf den Bereitstellungscomputer. Weitere Informationen hierzu finden Sie unter Installer-Tool (Installutil.exe). Diese Datei wird verwendet, um Informationen über den ursprünglichen Zustand des Systems vor der Installation der Ressourcen und über die Änderungen zu speichern, die während der Installation vorgenommenen wurden. Diese Datei wird in allen Methoden der Installationskomponente verwendet:

  • Die Install-Methode greift auf eine leere Kopie dieser Datei zu und verwendet sie zum Aufzeichnen von Informationen über alle Installationen, die erfolgreich von ihr durchgeführt wurden.

  • Die Commit-Methode empfängt Informationen von der Datei im savedState-Parameter. Wenn Sie möchten, können Sie mithilfe des IDictionary-Objekts mit dem Inhalt dieser Datei arbeiten.

  • Die Rollback-Methode empfängt Informationen von der Datei im savedState-Parameter und verwendet sie, um vorhergehende Transaktionen rückgängig zu machen, wenn bei der Install-Methode ein Fehler auftritt. Nach Abschluss des Rollbacks wird die Zustandsdatei gelöscht.

  • Die Uninstall-Methode empfängt Informationen von der Datei im savedState-Parameter und verwendet die Datei zum Wiederherstellen des ursprünglichen Zustands des Systems.

Die .InstallState-Datei wird auf dem Bereitstellungscomputer in dem Verzeichnis gespeichert, in dem die DLL des Projekts installiert ist. Sie sollten diese Datei nicht direkt bearbeiten, Sie können jedoch das IDictionary-Objekt für die Arbeit mit deren Inhalten verwenden.

Siehe auch

Konzepte

Einführung in Installationskomponenten