System.Configuration.Install Przestrzeń nazw

Udostępnia klasy, które umożliwiają pisanie niestandardowych instalatorów 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

Stanowi podstawę instalacji niestandardowych.

InstallerCollection

Zawiera kolekcję instalatorów do uruchomienia podczas instalacji.

InstallEventArgs

Dostarcza dane dla zdarzeń: BeforeInstall, , CommittingAfterInstall, CommittedBeforeRollback, , 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ć BeforeInstallzdarzenie , , BeforeRollbackCommittedAfterRollbackCommittingAfterInstall, , BeforeUninstalllub .InstallerAfterUninstall

Uwagi

Installers Za pomocą właściwości instalator zawiera kolekcję innych instalatorów jako elementów podrzędnych. Podczas wykonywania instalatora przechodzi przez jego elementy podrzędne i wywołuje Installmetody , Commit, , Rollbacklub Uninstall. Przykład obiektu w kolekcji Installers można znaleźć w temacie 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 Uninstall metodę, oraz wiersz polecenia wprowadzony podczas uruchamiania pliku wykonywalnego instalacji. Aby zapoznać się z przykładem pliku wykonywalnego instalacji, zobacz Installutil.exe (Narzędzie instalatora).

Metody Install, , RollbackCommiti Uninstall nie zawsze są wywoływane w tym samym wystąpieniu klasy Installer. Możesz na przykład użyć elementu Installer , aby zainstalować i zatwierdzić aplikację, a następnie zwolnić odwołanie do tego Installerelementu . Później odinstalowanie aplikacji powoduje utworzenie nowego odwołania do Installerobiektu , co oznacza, że Uninstall metoda jest wywoływana w innym wystąpieniu klasy Installer. Z tego powodu nie zapisuj stanu komputera w instalatorze. Zamiast tego należy użyć elementu IDictionary , który jest zachowywany między wywołaniami i przekazywany do Installmetod , Commit, Rollbacki Uninstall .