ServiceProcessInstaller.Install(IDictionary) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Écrit dans le Registre des informations relatives à l'application de service. Cette méthode est prévue pour être utilisée par des outils d'installation qui appellent automatiquement les méthodes appropriées.
public:
override void Install(System::Collections::IDictionary ^ stateSaver);
public override void Install (System.Collections.IDictionary stateSaver);
override this.Install : System.Collections.IDictionary -> unit
Public Overrides Sub Install (stateSaver As IDictionary)
Paramètres
- stateSaver
- IDictionary
IDictionary qui contient les informations de contexte associées à l'installation.
Exceptions
Le stateSaver
est null
.
Remarques
Normalement, vous n’appelez pas les méthodes sur dans ServiceProcessInstaller votre code ; elles sont généralement appelées uniquement par l’utilitaire d’installation. L’utilitaire d’installation appelle automatiquement la ServiceProcessInstaller.Install méthode pendant le processus d’installation. Si nécessaire, il effectue une sauvegarde des défaillances en appelant Rollback sur tous les composants précédemment installés. Cette méthode transmet l’installation à la méthode de classe Installer.Install de base.
Normalement, vous n’appelez pas les méthodes sur ServiceInstaller dans votre code ; elles sont généralement appelées uniquement par l’utilitaire d’installation. L’utilitaire d’installation appelle automatiquement les ServiceProcessInstaller.Install méthodes et ServiceInstaller.Install pendant le processus d’installation. Il sauvegarde les défaillances, si nécessaire, en appelant Rollback (ou ServiceInstaller.Rollback) sur tous les composants précédemment installés
La routine d’installation d’une application conserve automatiquement des informations sur les composants déjà installés, à l’aide du programme d’installation du Installer.Contextprojet. Ces informations d’état, passées dans Install en tant que stateSaver
paramètre, sont mises à jour en permanence en tant que ServiceProcessInstaller instance et chaque ServiceInstaller instance est installé par l’utilitaire. Il n’est généralement pas nécessaire que votre code modifie explicitement ces informations d’état.
Install transmet à la méthode appelante toutes les exceptions levées par des méthodes de classe de base ou BeforeInstall / AfterInstall des gestionnaires d’événements.