EventLogInstaller.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.
Effectue l’installation et écrit les informations du journal des événements dans le Registre.
public:
override void Install(System::Collections::IDictionary ^ stateSaver);public override void Install(System.Collections.IDictionary stateSaver);override this.Install : System.Collections.IDictionary -> unitPublic Overrides Sub Install (stateSaver As IDictionary)Paramètres
- stateSaver
- IDictionary
Utilisé IDictionary pour enregistrer les informations nécessaires pour effectuer une opération de restauration ou de désinstallation.
Exceptions
Le nom spécifié dans la Source propriété est déjà inscrit pour un autre journal des événements.
Remarques
La Install méthode écrit les informations du journal des événements dans le Registre et associe le journal des événements à un journal spécifié par la Log propriété. Si le journal n’existe pas déjà (et qu’une source est spécifiée), Install crée un journal et associe la nouvelle source à celle-ci.
En règle générale, vous n’appelez pas les méthodes de votre EventLogInstaller code ; elles sont généralement appelées uniquement par l'Installutil.exe (Outil Programme d’installation). L’outil appelle automatiquement la Install méthode pendant le processus d’installation pour écrire des informations de Registre associées au journal des événements en cours d’installation. L’installation est transactionnelle. Par conséquent, en cas de défaillance d’un composant de projet d’installation pendant l’installation, tous les composants précédemment installés sont restaurés dans leurs états de préinstallation. Pour ce faire, appelez la méthode de Rollback chaque composant.
Permet EventLogInstaller d’inscrire une nouvelle source pour un journal des événements nouveau ou existant ; n’utilisez EventLogInstaller pas pour modifier une source existante. La EventLogInstaller classe ne modifie pas les propriétés de configuration d’une source existante pour correspondre aux propriétés d’installation spécifiées. La Install méthode lève une exception si la Source propriété correspond à un nom source inscrit pour un autre journal des événements sur l’ordinateur. La Install méthode ignore l’inscription de la source si la Source propriété correspond à un nom de source déjà inscrit pour le même journal des événements spécifié dans la Log propriété.
La routine d’installation d’une application utilise la propriété du programme d’installation du Installer.Context projet pour conserver automatiquement des informations sur les composants qui ont déjà été installés. Ces informations d’état, qui sont transmises en Install tant que stateSaver paramètre, sont mises à jour en continu à mesure que l’outil installe chacun EventLogInstaller. En règle générale, il n’est pas nécessaire que votre code modifie explicitement ces informations d’état.
