System.Configuration.Install Namespace

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.