System.Configuration.Install Namespace

Пространство имен System.Configuration.Install предоставляет классы, позволяющие писать настраиваемые установщики для пользовательских компонентов. The System.Configuration.Install namespace provides classes that allow you to write custom installers for your own components. Класс Installer является базовым для всех настраиваемых установщиков в .NET Framework. The Installer class is the base class for all custom installers in the .NET Framework.

Классы

AssemblyInstaller

Загружает сборку и запускает все установщики в нем.Loads an assembly, and runs all the installers in it.

ComponentInstaller

Задает установщик, копирующий свойства из компонента для использования во время установки.Specifies an installer that copies properties from a component to use at install time.

InstallContext

Содержит сведения о текущей установке.Contains information about the current installation.

Installer

Предоставляет основу для пользовательских установок.Provides the foundation for custom installations.

InstallerCollection

Содержит коллекцию установщиков, запускаемых во время установки.Contains a collection of installers to be run during an installation.

InstallEventArgs

Предоставляет данные для событий BeforeInstall, AfterInstall, Committing, Committed, BeforeRollback, AfterRollback, BeforeUninstall, AfterUninstall.Provides data for the events: BeforeInstall, AfterInstall, Committing, Committed, BeforeRollback, AfterRollback, BeforeUninstall, AfterUninstall.

InstallException

Исключение, которое вызывается во время установки при возникновении ошибки в фазе фиксации, отката или отмены установки.The exception that is thrown when an error occurs during the commit, rollback, or uninstall phase of an installation.

ManagedInstallerClass

Представляет управляемую установку.Represents a managed install.

TransactedInstaller

Определяет установщик, который либо завершается успешно, либо, если происходит сбой, оставляет компьютер в исходном состоянии.Defines an installer that either succeeds completely or fails and leaves the computer in its initial state.

Интерфейсы

IManagedInstaller

Обеспечивает интерфейс для управляемого установщика.Provides an interface for a managed installer.

Перечисления

UninstallAction

Задает действия установщика во время отмены установки.Specifies what an installer should do during an uninstallation.

Делегаты

InstallEventHandler

Представляет метод, обрабатывающий события BeforeInstall, AfterInstall, Committing, Committed, BeforeRollback, AfterRollback, BeforeUninstall или событие AfterUninstall для Installer.Represents the method that will handle the BeforeInstall, AfterInstall, Committing, Committed, BeforeRollback, AfterRollback, BeforeUninstall, or AfterUninstall event of an Installer.

Комментарии

Через Installers свойство, установщик содержит коллекцию дочерних установщиков.Through the Installers property, an installer contains a collection of other installers as children. Как выполняется установщик, он выполняет циклический переход по его дочерних элементов и вызовы Install, Commit, Rollback, или Uninstall.As the installer is executed, it cycles through its children and calls Install, Commit, Rollback, or Uninstall. Пример объекта в Installers коллекции, см. в разделе EventLogInstaller.For an example of an object in the Installers collection, see EventLogInstaller.

Context Свойство содержит сведения об установке.The Context property contains information about the installation. Например, сведения о расположении файла журнала установки и расположение файла, который сохраняет сведения, необходимые Uninstall метод и командной строки, введенные при запуске исполняемого файла установки.For example, information about the location of the log file for the installation, the location of the file that saves information required by the Uninstall method, and the command line that was entered when the installation executable was run. Пример исполняемого кода установки, см. в разделе Installutil.exe (средство установки).For an example of an installation executable, see Installutil.exe (Installer Tool).

Install, Commit, Rollback, И Uninstall методов не всегда вызываются в том же экземпляре Installer.The Install, Commit, Rollback, and Uninstall methods are not always called on the same instance of Installer. Например, можно использовать Installer для установки и фиксации приложения и затем освободить ссылку на эту Installer.For example, you might use an Installer to install and commit an application, and then release the reference to that Installer. Позже, при удалении приложения создается новая ссылка Installer, означающее, что Uninstall для другого экземпляра вызывается метод Installer.Later, uninstalling the application creates a new reference to an Installer, which means that the Uninstall method is called on a different instance of Installer. По этой причине не следует сохранять состояние компьютера в установщик.For this reason, do not save the state of a computer in an installer. Вместо этого используйте IDictionary , вызовах и передается в Install, Commit, Rollback, и Uninstall методы.Instead, use an IDictionary that is preserved across calls and passed into the Install, Commit, Rollback, and Uninstall methods.