System.Configuration.Install Namespace

El espacio de nombres System.Configuration.Install proporciona clases que permiten escribir instaladores personalizados para componentes propios. The System.Configuration.Install namespace provides classes that allow you to write custom installers for your own components. La clase Installer es la clase base para todos los instaladores personalizados de .NET Framework. The Installer class is the base class for all custom installers in the .NET Framework.

Clases

AssemblyInstaller

Carga un ensamblado y ejecuta todos los instaladores que contiene.Loads an assembly, and runs all the installers in it.

ComponentInstaller

Especifica un instalador que copia las propiedades de un componente para utilizarlas en tiempo de instalación.Specifies an installer that copies properties from a component to use at install time.

InstallContext

Contiene información sobre la actual instalación.Contains information about the current installation.

Installer

Proporciona la base para las instalaciones personalizadas.Provides the foundation for custom installations.

InstallerCollection

Contiene una colección de instaladores que se ejecutan durante una instalación.Contains a collection of installers to be run during an installation.

InstallEventArgs

Proporciona datos para los eventos: BeforeInstall, AfterInstall, Committing, Committed, BeforeRollback, AfterRollback, BeforeUninstall y AfterUninstall.Provides data for the events: BeforeInstall, AfterInstall, Committing, Committed, BeforeRollback, AfterRollback, BeforeUninstall, AfterUninstall.

InstallException

Excepción que se produce cuando se genera un error durante la fase en la que se confirma, se revierte o se desinstala una instalación.The exception that is thrown when an error occurs during the commit, rollback, or uninstall phase of an installation.

ManagedInstallerClass

Representa una instalación administrada.Represents a managed install.

TransactedInstaller

Define un instalador que se ejecuta de manera totalmente satisfactoria o incorrecta y que mantiene el estado inicial del equipo.Defines an installer that either succeeds completely or fails and leaves the computer in its initial state.

Interfaces

IManagedInstaller

Proporciona una interfaz para un instalador administrado.Provides an interface for a managed installer.

Enumeraciones

UninstallAction

Especifica lo que debe hacer un instalador durante una operación de desinstalación.Specifies what an installer should do during an uninstallation.

Delegados

InstallEventHandler

Representa el método que controlará el evento BeforeInstall, AfterInstall, Committing, Committed, BeforeRollback, AfterRollback, BeforeUninstall o AfterUninstall de un Installer.Represents the method that will handle the BeforeInstall, AfterInstall, Committing, Committed, BeforeRollback, AfterRollback, BeforeUninstall, or AfterUninstall event of an Installer.

Comentarios

A través de la Installers propiedad, un instalador contiene una colección de otros instaladores como elementos secundarios.Through the Installers property, an installer contains a collection of other installers as children. Cuando se ejecuta el instalador, recorre sus elementos secundarios y las llamadas Install, Commit, Rollback, o Uninstall.As the installer is executed, it cycles through its children and calls Install, Commit, Rollback, or Uninstall. Para obtener un ejemplo de un objeto en el Installers colección, consulte EventLogInstaller.For an example of an object in the Installers collection, see EventLogInstaller.

El Context propiedad contiene información sobre la instalación.The Context property contains information about the installation. Por ejemplo, información sobre la ubicación del archivo de registro para la instalación, la ubicación del archivo que guarda la información requerida por el Uninstall método y la línea de comandos que se especificaron al ejecuta el ejecutable de instalación.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. Para obtener un ejemplo de un ejecutable de instalación, consulte Installutil.exe (herramienta Installer).For an example of an installation executable, see Installutil.exe (Installer Tool).

El Install, Commit, Rollback, y Uninstall métodos no siempre se llaman en la misma instancia de Installer.The Install, Commit, Rollback, and Uninstall methods are not always called on the same instance of Installer. Por ejemplo, podría usar un Installer para instalar y confirmar una aplicación y, a continuación, suelte la referencia a esa Installer.For example, you might use an Installer to install and commit an application, and then release the reference to that Installer. Más adelante, al desinstalar la aplicación crea una nueva referencia a un Installer, lo que significa que el Uninstall se llama al método en una instancia diferente de 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. Por este motivo, no guarde el estado de un equipo en un instalador.For this reason, do not save the state of a computer in an installer. En su lugar, use un IDictionary que se conserva en las llamadas y se pasa a la Install, Commit, Rollback, y Uninstall métodos.Instead, use an IDictionary that is preserved across calls and passed into the Install, Commit, Rollback, and Uninstall methods.