Partager via


ServiceProcessInstaller.Install(IDictionary) Méthode

Définition

É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.

S’applique à

Voir aussi