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 Sie benutzerdefinierte Installationsprogramme für Ihre eigenen Komponenten schreiben können. Die Installer Klasse ist die Basisklasse für alle benutzerdefinierten Installationsprogramme in .NET Framework.
Klassen
| Name | Beschreibung |
|---|---|
| AssemblyInstaller |
Lädt eine Assembly und führt alle Installationsprogramme darin aus. |
| ComponentInstaller |
Gibt ein Installationsprogramm an, das Eigenschaften aus einer Komponente kopiert, die zur Installationszeit verwendet werden sollen. |
| InstallContext |
Enthält Informationen zur aktuellen Installation. |
| Installer |
Stellt die Grundlage für benutzerdefinierte Installationen bereit. |
| InstallerCollection |
Enthält eine Auflistung von Installationsprogrammen, die während einer Installation ausgeführt werden sollen. |
| InstallEventArgs |
Stellt Daten für die Ereignisse bereit: BeforeInstall, , AfterInstall, CommittedCommitting, BeforeRollback, AfterRollback, , . BeforeUninstallAfterUninstall |
| 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 erfolgreich ist oder fehlschlägt und den Computer in seinem Anfangszustand verlässt. |
Schnittstellen
| Name | Beschreibung |
|---|---|
| IManagedInstaller |
Stellt eine Schnittstelle für ein verwaltetes Installationsprogramm bereit. |
Enumerationen
| Name | Beschreibung |
|---|---|
| UninstallAction |
Gibt an, was ein Installationsprogramm während einer Deinstallation tun soll. |
Delegaten
| Name | Beschreibung |
|---|---|
| InstallEventHandler |
Stellt die Methode dar, die das BeforeInstall, AfterInstall, , Committing, Committed, , BeforeRollback, , AfterRollback, , oder BeforeUninstallAfterUninstall das Ereignis eines .Installer |
Hinweise
Über die Installers Eigenschaft enthält ein Installationsprogramm eine Sammlung anderer Installationsprogramme als untergeordnete Elemente. Wenn das Installationsprogramm ausgeführt wird, wechselt es durch seine untergeordneten Elemente und Aufrufe Install, , Commit, Rollbackoder Uninstall. Ein Beispiel für ein Objekt in der Installers Auflistung finden Sie unter EventLogInstaller.
Die Context Eigenschaft enthält Informationen zur Installation. Beispielsweise informationen zum Speicherort der Protokolldatei für die Installation, zum Speicherort der Datei, die für die Uninstall Methode erforderlichen 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 (Installer Tool).
Die InstallMethoden , Commit, , Rollbackund Uninstall Methoden werden nicht immer für dieselbe Instanz von Installeraufgerufen. Sie können z. B. eine Installer Anwendung zum Installieren und Ausführen eines Commits verwenden und dann den Verweis auf diese InstallerAnwendung freigeben. Später erstellt die Deinstallation der Anwendung einen neuen Verweis auf einen Installer, was bedeutet, dass die Uninstall Methode für eine andere Instanz von Installeraufgerufen wird. Speichern Sie aus diesem Grund nicht den Status eines Computers in einem Installationsprogramm. Verwenden Sie stattdessen einIDictionary, das über Aufrufe hinweg beibehalten und an die InstallMethoden , Commit, und UninstallRollbackmethoden übergeben wird.
