EventLogInstaller Classe

Définition

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 de la source et le nom du journal des événements, puis ajoute à EventLogInstaller la Installers collection.

#using <System.dll>
#using <System.Configuration.Install.dll>

using namespace System;
using namespace System::Configuration::Install;
using namespace System::Diagnostics;
using namespace System::ComponentModel;

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

public:
   MyEventLogInstaller()
   {
      // Create an instance of an EventLogInstaller.
      myEventLogInstaller = gcnew 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 );
   }
};

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

le EventLogInstaller est utilisé par le Installutil.exe (outil 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 les 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.

Le programme d’installation crée la source d’événements 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 WriteEvent méthodes et WriteEntry 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 lors de l’installation de votre application. Cela laisse le temps au système d’exploitation d’actualiser sa liste de sources d’événements inscrites et 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’un EventLogInstaller, ou à l’aide de la CreateEventSource méthode . Vous devez disposer des droits d’administration sur l’ordinateur pour créer une source d’événement.

Vous pouvez créer une source d’événements 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 enregistre la source pour ce journal, mais le journal n’est créé qu’une fois que la première entrée n’y est pas écrite.

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

Lorsque le Installutil.exe (outil d’installation) est appelé, il examine le RunInstallerAttribute. S’il s’agit truede , l’outil installe tous les éléments de la Installers collection associés au programme d’installation de votre projet. Si RunInstallerAttribute a la valeur false, l’outil ignore le programme d’installation du projet.

Vous modifiez d’autres propriétés d’un EventLogInstaller avant ou après l’ajout de l’instance à la Installers collection du programme d’installation de votre 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.

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

Vous pouvez inscrire la source de l’événement avec des fichiers de ressources localisés pour votre catégorie d’événement et vos chaînes de message. Votre application peut écrire des entrées de journal des événements à l’aide d’identificateurs de ressource, 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 CategoryCountpropriétés , CategoryResourceFile, MessageResourceFileet ParameterResourceFile pour configurer la source afin d’é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 d’identificateurs de ressource et de 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. Il sauvegarde les échecs, si nécessaire, en appelant la Rollback méthode pour l’objet qui a généré l’exception.

Constructeurs

Propriétés

Méthodes

Événements

S’applique à

Voir aussi

• EventLog
• CreateEventSource
• Installutil.exe (outil Installer)