Gewusst wie: Überschreiben von Standardmethoden bei Installationskomponenten
Aktualisiert: November 2007
Standardmäßig verfügt jede Installationskomponente über folgende Methoden:
Install – Alle Installationsfunktionen, die das Installationsprogramm durchführen muss, werden innerhalb dieser Methode ausgeführt. Die Installer1-Klasse (oder eine andere Klasse, deren RunInstallerAttribute-Wert auf true festgelegt ist) ruft zu jeder in ihr enthaltenen Installationskomponente Install und anschließend entweder Commit (wenn die Installationen erfolgreich waren) oder Rollback (wenn Fehler aufgetreten sind) auf.
Commit – Commit wird aufgerufen, nachdem die Install-Methode auf allen Installationskomponenten erfolgreich ausgeführt wurde, die die Installationsprogrammklasse enthält. An dieser Stelle wird für alle Installationen ein Commit ausgeführt. Um ein Auslösen von Ausnahmen zu verhindern, erfolgt normalerweise in der Commit-Methode keine Verarbeitung.
Rollback – Die Rollback-Methode wird verwendet, um alle vorhergehenden Installationen rückgängig zu machen, falls innerhalb des Installationsprozesses ein Fehler aufgetreten ist. Wenn eine der Installationskomponenten, die in der Installationsprogrammklasse enthalten sind, einen Fehler auslöst, werden alle bis zu diesem Zeitpunkt ausgeführten Installationen rückgängig gemacht.
Uninstall – Uninstall wird verwendet, um Ressourcen von Installationskomponenten vom System zu entfernen. Im Gegensatz zur Installation ist die Deinstallation nicht transaktional. Wenn ein Deinstallationprozess fehlschlägt, versucht das System weiterhin, alle anderen Ressourcen zu deinstallieren.
Jede dieser Methoden enthält eine Standardverarbeitung, die die erforderliche Arbeit ohne Änderung ausführt. Falls gewünscht, können Sie die Verarbeitung in jedem Schritt überschreiben und ändern. Bei einer ServiceBase-Installationskomponente könnten Sie z. B. die Standardverarbeitung, die in der Commit-Prozedur auftritt, so ändern, dass der Installationsprozess den Dienst nach dessen erfolgreicher Installation startet. Sie können die Uninstall-Prozedur auch so ändern, dass alle Dienste vor ihrer Deinstallation beendet werden.
So überschreiben Sie Standardmethoden für eine Installationskomponente
Öffnen Sie die Installationsprogrammklasse, nachdem Sie eine Installationskomponente zur Projektmappe hinzugefügt haben.
Suchen Sie die Installationskomponente, die Sie ändern möchten, und greifen Sie im Code-Editor darauf zu.
Überschreiben Sie die entsprechende Methode, und fügen Sie die gewünschte Funktion hinzu. Weitere Informationen hierzu finden Sie unter Überschreiben von Eigenschaften und Methoden.
.gif "Tipp")
Tipp:Stellen Sie sicher, dass die ursprüngliche Verarbeitung für Installation, Commit, Rollback oder Deinstallation der Ressourcen beibehalten wird, wenn Sie Methoden in der Installer1-Klasse überschreiben. Im Allgemeinen sollten Sie Code zu bestehenden Funktionen hinzufügen und keine bestehenden Funktionen entfernen.
Siehe auch
Aufgaben
Gewusst wie: Hinzufügen von Installationskomponenten zu Projekten
Gewusst wie: Konfigurieren von Installationskomponenten
Exemplarische Vorgehensweise: Installieren einer Ereignisprotokollkomponente