System.Configuration.Install Przestrzeń nazw

Udostępnia klasy, które umożliwiają pisanie instalatorów niestandardowych dla własnych składników. Klasa Installer jest klasą bazową dla wszystkich instalatorów niestandardowych w .NET Framework.

Klasy

AssemblyInstaller

Ładuje zestaw i uruchamia wszystkie instalatory w nim.

ComponentInstaller

Określa instalatora, który kopiuje właściwości z składnika do użycia w czasie instalacji.

InstallContext

Zawiera informacje o bieżącej instalacji.

Installer

Zapewnia podstawę instalacji niestandardowych.

InstallerCollection

Zawiera kolekcję instalatorów do uruchomienia podczas instalacji.

InstallEventArgs

Zawiera dane dotyczące zdarzeń: BeforeInstall, AfterInstallCommittedBeforeRollbackCommitting, AfterRollback, BeforeUninstall, . AfterUninstall

InstallException

Wyjątek zgłaszany w przypadku wystąpienia błędu podczas fazy zatwierdzania, wycofywania lub odinstalowywania instalacji.

ManagedInstallerClass

Reprezentuje instalację zarządzaną.

TransactedInstaller

Definiuje instalatora, który kończy się powodzeniem lub niepowodzeniem i opuszcza komputer w stanie początkowym.

Interfejsy

IManagedInstaller

Udostępnia interfejs dla zarządzanego instalatora.

Wyliczenia

UninstallAction

Określa, co instalator powinien zrobić podczas odinstalowywania.

Delegaci

InstallEventHandler

Reprezentuje metodę, która będzie obsługiwać BeforeInstall zdarzenie , , , , , , lub AfterInstall Committing Committed BeforeRollback AfterRollback BeforeUninstall AfterUninstall Installer .

Uwagi

Za Installers pośrednictwem właściwości instalator zawiera kolekcję innych instalatorów jako elementy children. Podczas wykonywania instalatora przechodzi on przez jego dzieci i wywołuje Install , Commit , lub Rollback Uninstall . Aby uzyskać przykład obiektu w Installers kolekcji, zobacz EventLogInstaller .

Właściwość Context zawiera informacje o instalacji. Na przykład informacje o lokalizacji pliku dziennika instalacji, lokalizacji pliku, który zapisuje informacje wymagane przez metodę, oraz wiersza polecenia wprowadzonego podczas uruchamiania pliku wykonywalnego Uninstall instalacji. Aby uzyskać przykład pliku wykonywalnego instalacji, zobacz Installutil.exe (narzędzie instalatora).

Metody , , i nie Install Commit zawsze są Rollback Uninstall wywoływane w tym samym wystąpieniu klasy Installer . Na przykład można użyć do zainstalowania i zatwierdzenia aplikacji, a następnie zwolnić Installer odwołanie do tego . Installer Później odinstalowanie aplikacji powoduje utworzenie nowego odwołania do klasy , co oznacza, że metoda jest wywoływana Installer Uninstall w innym wystąpieniu klasy Installer . Z tego powodu nie należy zapisywać stanu komputera w instalatorze. Zamiast tego należy użyć metody IDictionary , która jest zachowywana między wywołaniami i przekazywana do metod , Install , i Commit Rollback Uninstall .