Freigeben über


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.