System.Configuration.Install-Namespace

Der 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 Installationsprogramme in .NET Framework. Über die Installer.Installers-Eigenschaft enthält ein Installationsprogramm eine Auflistung weiterer Installationsprogramme als untergeordnete Elemente. Wenn das Installationsprogramm ausgeführt wird, durchläuft es die zugehörigen untergeordneten Elemente und ruft System.Configuration.Install.Installer.Install, System.Configuration.Install.Installer.Commit, System.Configuration.Install.Installer.Rollback oder System.Configuration.Install.Installer.Uninstall auf. Ein Beispiel für ein Objekt in der Installers-Auflistung finden Sie unter EventLogInstaller. Die Context-Eigenschaft enthält Informationen über die Installation. Dazu gehören z. B. Informationen über den Speicherort der Protokolldatei für die Installation, über den Speicherort der Datei, in der für die Uninstall-Methode erforderliche Daten gespeichert sind, sowie die Befehlszeile, die zum Ausführen der Installationsdatei eingegeben wurde. Ein Beispiel für eine ausführbare Installationsdatei finden Sie unter Installer-Tool (Installutil.exe). Die Methoden Install, Commit, Rollback und Uninstall werden nicht immer für dieselbe Instanz von Installer aufgerufen. Sie können z. B. einen Installer zum Installieren und für den Commit einer Anwendung verwenden und dann den Verweis auf diesen Installer freigeben. Bei einer späteren Deinstallation der Anwendung wird ein neuer Verweis auf einen Installer erstellt. Dies bedeutet, dass die Uninstall-Methode für eine andere Instanz von Installer aufgerufen wird. Aus diesem Grund darf der Zustand eines Computers nicht in einem Installationsprogramm gespeichert werden. Verwenden Sie stattdessen ein IDictionary, das für alle Aufrufe beibehalten und an die Methoden Install, Commit, Rollback und Uninstall übergeben wird.

Klassen

	Klasse	Beschreibung
	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
	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

	Schnittstelle	Beschreibung
	IManagedInstaller

Delegaten

	Delegat	Beschreibung
	InstallEventHandler	Stellt die Methode dar, die die Ereignisse BeforeInstall, AfterInstall, Committing, Committed, BeforeRollback, AfterRollback, BeforeUninstall oder AfterUninstall von Installer behandelt.

Enumerationen

	Enumeration	Beschreibung
	UninstallAction	Gibt an, welche Aktionen ein Installationsprogramm während einer Deinstallation ausführen soll.