System.Configuration.Install Namespace
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt Klassen bereit, mit denen benutzerdefinierte Installationsprogramme für eigene Komponenten geschrieben werden können. Die Installer-Klasse ist die Basisklasse für alle benutzerdefinierten Installer in .NET Framework.
Klassen
| AssemblyInstaller |
Lädt eine Assembly und führt alle darin enthaltenen Installationsprogramme aus. |
| ComponentInstaller |
Gibt ein Installationsprogramm an, das Eigenschaften aus einer Komponente kopiert, die bei der Installation verwendet werden sollen. |
| InstallContext |
Enthält Informationen über die derzeitige Installation. |
| Installer |
Stellt die Grundlage für benutzerdefinierte Installationen bereit. |
| InstallerCollection |
Enthält eine Auflistung der Installationsprogramme, die während einer Installation ausgeführt werden sollen. |
| InstallEventArgs |
Stellt Daten für die Ereignisse BeforeInstall, AfterInstall, Committing, Committed, BeforeRollback, AfterRollback, BeforeUninstall und AfterUninstall bereit. |
| InstallException |
Die Ausnahme, die ausgelöst wird, wenn während der Commit-, Rollback- oder Deinstallationsphase einer Installation ein Fehler auftritt. |
| ManagedInstallerClass |
Stellt eine verwaltete Installation dar. |
| TransactedInstaller |
Definiert ein Installationsprogramm, das entweder vollständig ausgeführt wird oder fehlschlägt und in letzterem Fall den Computer im ursprünglichen Zustand belässt. |
Schnittstellen
| IManagedInstaller |
Stellt eine Schnittstelle für ein verwaltetes Installationsprogramm bereit. |
Enumerationen
| UninstallAction |
Gibt an, welche Aktionen ein Installationsprogramm während einer Deinstallation ausführen soll. |
Delegaten
| InstallEventHandler |
Stellt die Methode dar, die die Ereignisse BeforeInstall, AfterInstall, Committing, Committed, BeforeRollback, AfterRollback, BeforeUninstall oder AfterUninstall von Installer behandelt. |
Hinweise
Über die Installers -Eigenschaft enthält ein Installationsprogramm eine Auflistung anderer Installationsprogramme als untergeordnete Elemente. Während das Installationsprogramm ausgeführt wird, durchläuft es seine untergeordneten Elemente und ruft Install, Commitoder RollbackUninstallauf. Ein Beispiel für ein -Objekt in der Installers Auflistung finden Sie unter EventLogInstaller.
Die Context -Eigenschaft enthält Informationen zur Installation. Beispielsweise Informationen über den Speicherort der Protokolldatei für die Installation, den Speicherort der Datei, die die von der Uninstall Methode benötigten Informationen speichert, und die Befehlszeile, die beim Ausführen der ausführbaren Installationsdatei eingegeben wurde. Ein Beispiel für eine ausführbare Installationsdatei finden Sie unter Installutil.exe (Installationstool).
Die InstallMethoden , Commit, Rollback, und Uninstall werden nicht immer auf demselben instance von Installeraufgerufen. Beispielsweise können Sie ein Installer verwenden, um eine Anwendung zu installieren und zu committen und dann den Verweis auf diese Installerfreizugeben. Später wird durch das Deinstallieren der Anwendung ein neuer Verweis auf einen Installererstellt, was bedeutet, dass die Uninstall -Methode für eine andere instance von Installeraufgerufen wird. Aus diesem Grund speichern Sie den Zustand eines Computers nicht in einem Installationsprogramm. Verwenden Sie stattdessen ein IDictionary , das über Aufrufe hinweg beibehalten und an die InstallMethoden , Commit, Rollbackund Uninstall übergeben wird.
