System.Configuration.Install Namespace

Lo spazio dei nomi System.Configuration.Install comprende classi che consentono di scrivere programmi di installazione personalizzati per i componenti. The System.Configuration.Install namespace provides classes that allow you to write custom installers for your own components. La classe Installer è la classe base per tutti i programmi di installazione personalizzati di .NET Framework. The Installer class is the base class for all custom installers in the .NET Framework.

Classi

AssemblyInstaller

Carica un assembly ed esegue tutti i programmi di installazione in esso contenuti.Loads an assembly, and runs all the installers in it.

ComponentInstaller

Specifica un programma di installazione che consente di copiare le proprietà da un componente da utilizzare in fase di installazione.Specifies an installer that copies properties from a component to use at install time.

InstallContext

Contiene informazioni relative all'installazione corrente.Contains information about the current installation.

Installer

Fornisce la base per installazioni personalizzate.Provides the foundation for custom installations.

InstallerCollection

Contiene un insieme di programmi di installazione da eseguire durante un'installazione.Contains a collection of installers to be run during an installation.

InstallEventArgs

Fornisce i dati per i seguenti eventi: BeforeInstall, AfterInstall, Committing, Committed, BeforeRollback, AfterRollback, BeforeUninstall, AfterUninstall.Provides data for the events: BeforeInstall, AfterInstall, Committing, Committed, BeforeRollback, AfterRollback, BeforeUninstall, AfterUninstall.

InstallException

Eccezione generata quando si verifica un errore durante la fase di commit, rollback o disinstallazione di un'installazione.The exception that is thrown when an error occurs during the commit, rollback, or uninstall phase of an installation.

ManagedInstallerClass

Rappresenta un'installazione gestita.Represents a managed install.

TransactedInstaller

Definisce un programma di installazione che ha esito positivo o negativo, lasciando il computer, in quest'ultimo caso, nello stato iniziale.Defines an installer that either succeeds completely or fails and leaves the computer in its initial state.

Interfacce

IManagedInstaller

Fornisce un'interfaccia per un programma di installazione gestito.Provides an interface for a managed installer.

Enumerazioni

UninstallAction

Specifica le operazioni che dovranno essere eseguite in un programma di installazione durante una disinstallazione.Specifies what an installer should do during an uninstallation.

Delegati

InstallEventHandler

Rappresenta il metodo che gestirà l'evento BeforeInstall, AfterInstall, Committing, Committed, BeforeRollback, AfterRollback, BeforeUninstall o AfterUninstall di un oggetto Installer.Represents the method that will handle the BeforeInstall, AfterInstall, Committing, Committed, BeforeRollback, AfterRollback, BeforeUninstall, or AfterUninstall event of an Installer.

Commenti

Tramite il Installers proprietà, un programma di installazione contiene una raccolta di altri programmi di installazione come elementi figlio.Through the Installers property, an installer contains a collection of other installers as children. Il programma di installazione viene eseguita, scorre i relativi elementi figlio e le chiamate Install, Commit, Rollback, o Uninstall.As the installer is executed, it cycles through its children and calls Install, Commit, Rollback, or Uninstall. Per un esempio di un oggetto nel Installers raccolta, vedere EventLogInstaller.For an example of an object in the Installers collection, see EventLogInstaller.

Il Context proprietà contiene informazioni relative all'installazione.The Context property contains information about the installation. Ad esempio, le informazioni relative al percorso del file di log per l'installazione, il percorso del file che salva le informazioni necessarie per il Uninstall metodo e la riga di comando che è stato immesso durante l'esecuzione di file eseguibile di installazione.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. Per un esempio di un file eseguibile di installazione, vedere Installutil.exe (strumento Installer).For an example of an installation executable, see Installutil.exe (Installer Tool).

Il Install, Commit, Rollback, e Uninstall metodi non vengono chiamati sempre nella stessa istanza di Installer.The Install, Commit, Rollback, and Uninstall methods are not always called on the same instance of Installer. Ad esempio, è possibile utilizzare un Installer per installare e il commit di un'applicazione e infine rilasciare il riferimento a tale Installer.For example, you might use an Installer to install and commit an application, and then release the reference to that Installer. In un secondo momento, disinstallare l'applicazione crea un nuovo riferimento a un Installer, vale a dire che il Uninstall metodo viene chiamato su un'istanza diversa di 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. Per questo motivo, non salvare lo stato di un computer in un programma di installazione.For this reason, do not save the state of a computer in an installer. Usare invece un' IDictionary che viene mantenuto tra le chiamate e passati i Install, Commit, Rollback, e Uninstall metodi.Instead, use an IDictionary that is preserved across calls and passed into the Install, Commit, Rollback, and Uninstall methods.