EventLogInstaller Classe

Définition

Espace de noms:

System.Diagnostics

Assembly:

System.Configuration.Install.dll

Vous permet d’installer et de configurer un journal des événements dans lequel votre application lit ou écrit quand elle est en cours d’exécution.

public ref class EventLogInstaller : System::Configuration::Install::ComponentInstaller

public class EventLogInstaller : System.Configuration.Install.ComponentInstaller

type EventLogInstaller = class
    inherit ComponentInstaller

Public Class EventLogInstaller
Inherits ComponentInstaller

Héritage

Object

MarshalByRefObject

Component

Installer

ComponentInstaller

EventLogInstaller

Exemples

L’exemple de code suivant définit les propriétés d’installation d’une nouvelle source d’événement. L’exemple de code définit le nom source et le nom du journal des événements, puis ajoute la EventLogInstallerInstallers collection.

using System;
using System.Configuration.Install;
using System.Diagnostics;
using System.ComponentModel;

[RunInstaller(true)]
public class MyEventLogInstaller: Installer
{
    private EventLogInstaller myEventLogInstaller;

    public MyEventLogInstaller()
    {
        // Create an instance of an EventLogInstaller.
        myEventLogInstaller = new EventLogInstaller();

        // Set the source name of the event log.
        myEventLogInstaller.Source = "NewLogSource";

        // Set the event log that the source writes entries to.
        myEventLogInstaller.Log = "MyNewLog";

        // Add myEventLogInstaller to the Installer collection.
        Installers.Add(myEventLogInstaller);
    }

    public static void Main()
    {
        MyEventLogInstaller myInstaller = new MyEventLogInstaller();
    }
}

   Imports System.Configuration.Install
Imports System.Diagnostics
Imports System.ComponentModel

<RunInstaller(True)>  _
Public Class MyEventLogInstaller
   Inherits Installer
   Private myEventLogInstaller As EventLogInstaller
   
   Public Sub New()

      ' Create an instance of an EventLogInstaller.
      myEventLogInstaller = New EventLogInstaller()

      ' Set the source name of the event log.
      myEventLogInstaller.Source = "NewLogSource"

      ' Set the event log that the source writes entries to.
      myEventLogInstaller.Log = "MyNewLog"

      ' Add myEventLogInstaller to the Installer collection.
      Installers.Add(myEventLogInstaller)
   End Sub

 Public Shared Sub Main()
 End Sub
 Dim myInstaller As New EventLogInstaller()
End Class

Remarques

Il EventLogInstaller est utilisé par l' Installutil.exe (outil Programme d’installation) lors de l’installation d’un journal des événements. La EventLogInstaller classe peut installer les journaux des événements uniquement sur l’ordinateur local.

Utilisez la EventLogInstaller classe lorsque votre application écrit dans un journal des événements ; il n’est pas nécessaire d’utiliser un programme d’installation du journal des événements pour que votre application lise à partir d’un journal des événements. Les applications et services doivent écrire dans le journal des applications ou dans un journal personnalisé. Les pilotes de périphérique doivent écrire dans le journal système.

Note

Le journal de sécurité est en lecture seule.

Le programme d’installation crée la source d’événement que vous spécifiez dans la Source propriété et l’inscrit pour le journal des événements spécifié dans Log la propriété. Ce comportement est similaire à l’appel CreateEventSource sur le EventLog composant.

Utilisez les méthodes et WriteEntry les WriteEvent méthodes pour écrire des événements dans un journal des événements. Vous devez spécifier une source d’événement pour écrire des événements ; vous devez créer et configurer la source d’événement avant d’écrire la première entrée avec la source.

Créez la source d’événement pendant l’installation de votre application. Cela permet au système d’exploitation d’actualiser sa liste de sources d’événements inscrites et de leurs configurations. Si le système d’exploitation n’a pas actualisé sa liste de sources d’événements et que vous tentez d’écrire un événement avec la nouvelle source, l’opération d’écriture échoue. Vous pouvez configurer une nouvelle source à l’aide d’une EventLogInstallerou de la CreateEventSource méthode. Vous devez disposer de droits d’administration sur l’ordinateur pour créer une source d’événement.

Vous pouvez créer une source d’événement pour un journal des événements existant ou un nouveau journal des événements. Lorsque vous créez une source pour un nouveau journal des événements, le système inscrit la source de ce journal, mais le journal n’est pas créé tant que la première entrée n’est pas écrite.

Pour installer un journal des événements, créez une classe d’installation de projet qui hérite de Installer, puis définissez la RunInstallerAttribute classe truesur . Dans votre projet, créez un journal des EventLogInstaller événements dans lequel votre application écrira et ajoutez l’instance à votre classe d’installation de projet.

Lorsque l 'Installutil.exe (outil programme d’installation) est appelé, il examine le RunInstallerAttribute. Si c’est truele cas, l’outil installe tous les éléments de la Installers collection associés au programme d’installation de votre projet. Si RunInstallerAttribute c’est falsele cas, l’outil ignore le programme d’installation du projet.

Vous modifiez d’autres propriétés d’une EventLogInstaller instance avant ou après l’ajout de l’instance à la Installers collection de votre programme d’installation de projet, mais avant l’exécution de l’outil d’installation. Vous devez définir la Source propriété si votre application écrit dans le journal des événements.

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 n’inscrit pas 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é.

Vous pouvez inscrire la source d’événement avec des fichiers de ressources localisés pour votre catégorie d’événements et les chaînes de message. Votre application peut écrire des entrées de journal des événements à l’aide d’identificateurs de ressources, plutôt que de spécifier la chaîne réelle. L’Observateur d’événements utilise l’identificateur de ressource pour rechercher et afficher la chaîne correspondante à partir du fichier de ressources localisé en fonction des paramètres de langue actuels. Vous pouvez inscrire un fichier distinct pour les catégories d’événements, les messages et les chaînes d’insertion de paramètres, ou vous pouvez inscrire le même fichier de ressources pour les trois types de chaînes. Utilisez les propriétés , CategoryResourceFileet MessageResourceFileParameterResourceFile les CategoryCountpropriétés pour configurer la source pour écrire des entrées localisées dans le journal des événements. Si votre application écrit des valeurs de chaînes directement dans le journal des événements, vous n’avez pas besoin de définir ces propriétés.

La source doit être configurée pour écrire des entrées localisées ou pour écrire des chaînes directes. Si votre application écrit des entrées à l’aide des identificateurs de ressource et des valeurs de chaîne, vous devez inscrire deux sources distinctes. Par exemple, configurez une source avec des fichiers de ressources, puis utilisez cette source dans la WriteEvent méthode pour écrire des entrées à l’aide d’identificateurs de ressource dans le journal des événements. Créez une autre source sans fichiers de ressources, puis utilisez cette source dans la WriteEntry méthode pour écrire des chaînes directement dans le journal des événements à l’aide de cette source.

En règle générale, vous n’appelez pas les méthodes de la EventLogInstaller classe à partir de votre code ; elles sont généralement appelées uniquement par Installutil.exe. L’outil appelle automatiquement la Install méthode pendant le processus d’installation. Elle sauvegarde les échecs, si nécessaire, en appelant la Rollback méthode de l’objet qui a généré l’exception.

Constructeurs

Nom	Description
EventLogInstaller()	Initialise une nouvelle instance de la classe EventLogInstaller.

Propriétés

Nom	Description
CanRaiseEvents	Obtient une valeur indiquant si le composant peut déclencher un événement. (Hérité de Component)
CategoryCount	Obtient ou définit le nombre de catégories dans le fichier de ressources de catégorie.
CategoryResourceFile	Obtient ou définit le chemin d’accès du fichier de ressources qui contient des chaînes de catégorie pour la source.
Container	Obtient le IContainer fichier qui contient le Component. (Hérité de Component)
Context	Obtient ou définit des informations sur l’installation actuelle. (Hérité de Installer)
DesignMode	Obtient une valeur qui indique si la Component valeur est actuellement en mode création. (Hérité de Component)
Events	Obtient la liste des gestionnaires d’événements qui sont attachés à ce Component. (Hérité de Component)
HelpText	Obtient le texte d’aide de tous les programmes d’installation de la collection d’programmes d’installation. (Hérité de Installer)
Installers	Obtient la collection de programmes d’installation que contient ce programme d’installation. (Hérité de Installer)
Log	Obtient ou définit le nom du journal sur lequel définir la source.
MessageResourceFile	Obtient ou définit le chemin d’accès du fichier de ressources qui contient des chaînes de mise en forme de message pour la source.
ParameterResourceFile	Obtient ou définit le chemin d’accès du fichier de ressources qui contient des chaînes de paramètres de message pour la source.
Parent	Obtient ou définit le programme d’installation contenant la collection à laquelle appartient ce programme d’installation. (Hérité de Installer)
Site	Obtient ou définit le ISiteComponent. (Hérité de Component)
Source	Obtient ou définit le nom de la source à inscrire auprès du journal.
UninstallAction	Obtient ou définit une valeur qui indique si le Installutil.exe (outil Installer) doit supprimer le journal des événements ou le laisser dans son état installé au moment de la désinstallation.

Méthodes

Nom	Description
Commit(IDictionary)	En cas de substitution dans une classe dérivée, termine la transaction d’installation. (Hérité de Installer)
CopyFromComponent(IComponent)	Copie les valeurs de propriété d’un EventLog composant requis au moment de l’installation pour un journal des événements.
CreateObjRef(Type)	Crée un objet qui contient toutes les informations pertinentes requises pour générer un proxy utilisé pour communiquer avec un objet distant. (Hérité de MarshalByRefObject)
Dispose()	Libère toutes les ressources utilisées par le Component. (Hérité de Component)
Dispose(Boolean)	Libère les ressources non managées utilisées par les Component ressources gérées et libère éventuellement les ressources managées. (Hérité de Component)
Equals(Object)	Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object)
GetHashCode()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetLifetimeService()	Récupère l’objet de service de durée de vie actuel qui contrôle la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject)
GetService(Type)	Retourne un objet qui représente un service fourni par le Component ou par son Container. (Hérité de Component)
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
InitializeLifetimeService()	Obtient un objet de service de durée de vie pour contrôler la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject)
Install(IDictionary)	Effectue l’installation et écrit les informations du journal des événements dans le Registre.
IsEquivalentInstaller(ComponentInstaller)	Détermine si un programme d’installation et un autre programme d’installation spécifié font référence à la même source.
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
MemberwiseClone(Boolean)	Crée une copie superficielle de l’objet actuel MarshalByRefObject . (Hérité de MarshalByRefObject)
OnAfterInstall(IDictionary)	Déclenche l’événement AfterInstall. (Hérité de Installer)
OnAfterRollback(IDictionary)	Déclenche l’événement AfterRollback. (Hérité de Installer)
OnAfterUninstall(IDictionary)	Déclenche l’événement AfterUninstall. (Hérité de Installer)
OnBeforeInstall(IDictionary)	Déclenche l’événement BeforeInstall. (Hérité de Installer)
OnBeforeRollback(IDictionary)	Déclenche l’événement BeforeRollback. (Hérité de Installer)
OnBeforeUninstall(IDictionary)	Déclenche l’événement BeforeUninstall. (Hérité de Installer)
OnCommitted(IDictionary)	Déclenche l’événement Committed. (Hérité de Installer)
OnCommitting(IDictionary)	Déclenche l’événement Committing. (Hérité de Installer)
Rollback(IDictionary)	Restaure l’ordinateur à l’état où il était avant l’installation en supprimant les informations du journal des événements que la procédure d’installation a écrites dans le Registre.
ToString()	Retourne un String nom contenant le nom du Component, le cas échéant. Cette méthode ne doit pas être remplacée. (Hérité de Component)
Uninstall(IDictionary)	Supprime une installation en supprimant les informations du journal des événements du Registre.

Événements

Nom	Description
AfterInstall	Se produit après l’exécution Install(IDictionary) des méthodes de tous les programmes d’installation de la Installers propriété. (Hérité de Installer)
AfterRollback	Se produit après la restauration de tous les programmes d’installation de la Installers propriété. (Hérité de Installer)
AfterUninstall	Se produit après que tous les programmes d’installation de la Installers propriété effectuent leurs opérations de désinstallation. (Hérité de Installer)
BeforeInstall	Se produit avant l’exécution de la Install(IDictionary) méthode de chaque programme d’installation dans la collection d’installation. (Hérité de Installer)
BeforeRollback	Se produit avant que les programmes d’installation de la Installers propriété ne soient restaurés. (Hérité de Installer)
BeforeUninstall	Se produit avant que les programmes d’installation de la Installers propriété effectuent leurs opérations de désinstallation. (Hérité de Installer)
Committed	Se produit une fois que tous les programmes d’installation de la Installers propriété ont validé leurs installations. (Hérité de Installer)
Committing	Se produit avant que les programmes d’installation dans la Installers propriété valident leurs installations. (Hérité de Installer)
Disposed	Se produit lorsque le composant est supprimé par un appel à la Dispose() méthode. (Hérité de Component)

Voir aussi

• EventLog
• CreateEventSource
• Installutil.exe (outil programme d’installation)