Share via

EventLogInstaller.Install(IDictionary) Méthode

  • Référence

Définition

Espace de noms:
System.Diagnostics
Assembly:
System.Configuration.Install.dll

Exécute 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 -> unit
Public Overrides Sub Install (stateSaver As IDictionary)

Paramètres

stateSaver
IDictionary

IDictionary utilisé pour enregistrer les informations nécessaires à l'exécution d'une opération de restauration ou de désinstallation.

Exceptions

ArgumentException

Le nom spécifié dans la propriété Source est déjà enregistré pour un journal des événements différent.

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 lui associe la nouvelle source.

En règle générale, vous n’appelez pas les méthodes du EventLogInstaller à partir de votre code ; elles sont généralement appelées uniquement par le Installutil.exe (outil d’installation). L’outil appelle automatiquement la Install méthode pendant le processus d’installation pour écrire les informations de Registre associées au journal des événements en cours d’installation. L’installation est transactionnelle. Par conséquent, en cas d’échec d’un composant de projet d’installation pendant l’installation, tous les composants précédemment installés sont restaurés à leur état de préinstallation. Pour ce faire, appelez la méthode de Rollback chaque composant.

Utilisez EventLogInstaller pour 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 qu’elles correspondent 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 de 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 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 passées à Install en tant que stateSaver paramètre, sont mises à jour en continu à mesure que l’outil installe chaque EventLogInstaller. En règle générale, il n’est pas nécessaire que votre code modifie explicitement ces informations d’état.

S’applique à

Voir aussi