EventLogInstaller Klass

Definition

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

Arv

Object

MarshalByRefObject

Component

Installer

ComponentInstaller

EventLogInstaller

Exempel

I följande kodexempel anges installationsegenskaperna för en ny händelsekälla. Kodexemplet anger källnamnet och händelseloggnamnet och lägger till Installers i EventLogInstaller samlingen.

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

Kommentarer

EventLogInstaller Används av Installutil.exe (installationsverktyg) när du installerar en händelselogg. Klassen EventLogInstaller kan endast installera händelseloggar på den lokala datorn.

EventLogInstaller Använd klassen när ditt program skriver till en händelselogg. Det är inte nödvändigt att använda ett installationsprogram för händelseloggar för att programmet ska kunna läsa från en händelselogg. Program och tjänster bör skriva till programloggen eller en anpassad logg. Enhetsdrivrutiner bör skriva till systemloggen.

Installationsprogrammet skapar den händelsekälla som du anger i Source egenskapen och registrerar den för händelseloggen som anges i Log egenskapen. Det här beteendet liknar att anropa CreateEventSource komponenten EventLog .

WriteEvent Använd metoderna och WriteEntry för att skriva händelser till en händelselogg. Du måste ange en händelsekälla för att skriva händelser. du måste skapa och konfigurera händelsekällan innan du skriver den första posten med källan.

Skapa den nya händelsekällan under installationen av programmet. Detta gör det möjligt för operativsystemet att uppdatera sin lista över registrerade händelsekällor och deras konfigurationer. Om operativsystemet inte har uppdaterat sin lista över händelsekällor och du försöker skriva en händelse med den nya källan misslyckas skrivåtgärden. Du kan konfigurera en ny källa med hjälp av en EventLogInstaller, eller med hjälp av CreateEventSource metoden . Du måste ha administratörsbehörighet på datorn för att kunna skapa en ny händelsekälla.

Du kan skapa en händelsekälla för en befintlig händelselogg eller en ny händelselogg. När du skapar en ny källa för en ny händelselogg registrerar systemet källan för loggen, men loggen skapas inte förrän den första posten har skrivits till den.

Om du vill installera en händelselogg skapar du en projektinstallationsklass som ärver från Installeroch anger RunInstallerAttribute för klassen till true. I projektet skapar du en EventLogInstaller för varje händelselogg som programmet skriver till och lägger till instansen i projektinstallationsklassen.

När Installutil.exe (installationsverktyg) anropas, tittar den RunInstallerAttributepå . Om det är trueinstallerar verktyget alla objekt i samlingen Installers som är associerade med projektinstallationsprogrammet. Om RunInstallerAttribute är falseignorerar verktyget projektinstallationsprogrammet.

Du ändrar andra egenskaper för en EventLogInstaller före eller efter att du har lagt till instansen i Installers samlingen av projektinstallationsprogrammet, men innan installationsprogrammet körs. Du måste ange egenskapen Source om programmet ska skriva till händelseloggen.

Använd för att registrera en ny källa för en ny eller befintlig händelselogg. Använd EventLogInstallerEventLogInstaller inte för att ändra en befintlig källa. Klassen EventLogInstaller ändrar inte konfigurationsegenskaperna för en befintlig källa så att de matchar de angivna installationsegenskaperna. Metoden Install utlöser ett undantag om Source egenskapen matchar ett källnamn som är registrerat för en annan händelselogg på datorn. Metoden Install registrerar inte källan om Source egenskapen matchar ett källnamn som redan är registrerat för samma händelselogg som anges i Log egenskapen.

Du kan registrera händelsekällan med lokaliserade resursfiler för din händelsekategori och meddelandesträngar. Programmet kan skriva händelseloggposter med hjälp av resursidentifierare i stället för att ange den faktiska strängen. Zobrazovač udalostí använder resursidentifieraren för att hitta och visa motsvarande sträng från den lokaliserade resursfilen baserat på aktuella språkinställningar. Du kan registrera en separat fil för händelsekategorier, meddelanden och parameterinfogningssträngar, eller så kan du registrera samma resursfil för alla tre typerna av strängar. CategoryCountAnvänd egenskaperna , CategoryResourceFile, MessageResourceFileoch ParameterResourceFile för att konfigurera källan för att skriva lokaliserade poster till händelseloggen. Om programmet skriver strängvärden direkt till händelseloggen behöver du inte ange dessa egenskaper.

Källan måste konfigureras antingen för att skriva lokaliserade poster eller för att skriva direktsträngar. Om programmet skriver poster med både resursidentifierare och strängvärden måste du registrera två separata källor. Du kan till exempel konfigurera en källa med resursfiler och sedan använda källan WriteEvent i metoden för att skriva poster med hjälp av resursidentifierare till händelseloggen. Skapa en annan källa utan resursfiler och använd sedan källan WriteEntry i metoden för att skriva strängar direkt till händelseloggen med den källan.

Vanligtvis anropar du inte metoderna för EventLogInstaller klassen inifrån koden. De anropas vanligtvis endast av Installutil.exe. Verktyget anropar Install automatiskt metoden under installationsprocessen. Om det behövs säkerhetskopieras fel genom att anropa Rollback metoden för det objekt som genererade undantaget.

Se även

• EventLog
• CreateEventSource
• Installutil.exe (installationsverktyg)