EventLog Klass

Definition

public ref class EventLog : System::ComponentModel::Component, System::ComponentModel::ISupportInitialize

public class EventLog : System.ComponentModel.Component, System.ComponentModel.ISupportInitialize

type EventLog = class
    inherit Component
    interface ISupportInitialize

Public Class EventLog
Inherits Component
Implements ISupportInitialize

Arv

Object

MarshalByRefObject

Component

EventLog

Implementeringar

ISupportInitialize

Exempel

I följande exempel skapas händelsekällan MySource om den inte redan finns och skriver en post till händelseloggen MyNewLog.

using System;
using System.Diagnostics;
using System.Threading;

class MySample{

    public static void Main(){

        // Create the source, if it does not already exist.
        if(!EventLog.SourceExists("MySource"))
        {
             //An event log source should not be created and immediately used.
             //There is a latency time to enable the source, it should be created
             //prior to executing the application that uses the source.
             //Execute this sample a second time to use the new source.
            EventLog.CreateEventSource("MySource", "MyNewLog");
            Console.WriteLine("CreatedEventSource");
            Console.WriteLine("Exiting, execute the application a second time to use the source.");
            // The source is created.  Exit the application to allow it to be registered.
            return;
        }

        // Create an EventLog instance and assign its source.
        EventLog myLog = new EventLog();
        myLog.Source = "MySource";

        // Write an informational entry to the event log.
        myLog.WriteEntry("Writing to event log.");
    }
}

Option Explicit
Option Strict

Imports System.Diagnostics
Imports System.Threading

Class MySample
    Public Shared Sub Main()
        
        If Not EventLog.SourceExists("MySource") Then
            ' Create the source, if it does not already exist.
            ' An event log source should not be created and immediately used.
            ' There is a latency time to enable the source, it should be created
            ' prior to executing the application that uses the source.
            ' Execute this sample a second time to use the new source.
            EventLog.CreateEventSource("MySource", "MyNewLog")
            Console.WriteLine("CreatingEventSource")
            'The source is created.  Exit the application to allow it to be registered.
            Return
        End If
        
        ' Create an EventLog instance and assign its source.
        Dim myLog As New EventLog()
        myLog.Source = "MySource"
        
        ' Write an informational entry to the event log.    
        myLog.WriteEntry("Writing to event log.")
    End Sub
End Class

Kommentarer

EventLog kan du komma åt eller anpassa Windows händelseloggar som registrerar information om viktiga programvaru- eller maskinvaruhändelser. Med kan EventLogdu läsa från befintliga loggar, skriva poster till loggar, skapa eller ta bort händelsekällor, ta bort loggar och svara på loggposter. Du kan också skapa nya loggar när du skapar en händelsekälla.

Förutom att ge åtkomst till enskilda händelseloggar och deras poster EventLog kan du med klassen komma åt samlingen med alla händelseloggar. Du kan använda medlemmarna EventLog i static för att ta bort loggar, hämta logglistor, skapa eller ta bort en källa eller avgöra om en dator redan innehåller en viss källa.

Det finns tre standardhändelseloggar: Program, System och Säkerhet. En säkerhetslogg är skrivskyddad. Andra program och tjänster som du installerar, till exempel služba Active Directory, kan ha ytterligare händelseloggar.

Det finns säkerhetsöverväganden när du använder EventLog klassen. EventLog kräver EventLogPermission behörigheter för specifika åtgärder. Vi rekommenderar att EventLogPermission inte beviljas delvis betrodd kod. Du bör aldrig skicka något händelseloggobjekt, inklusive EventLogEntryCollection och EventLogEntry objekt, till mindre betrodd kod. Att till exempel skapa ett EventLog objekt, skriva en post och sedan skicka EventLog objektet till delvis betrodd kod kan skapa ett säkerhetsproblem, eftersom möjligheten att läsa och skriva till händelseloggen gör att kod kan utföra åtgärder som att utfärda händelseloggmeddelanden i namnet på ett annat program.

Från och med Windows Vista avgör UAC (User Account Control) en användares autentiseringsuppgifter. Om du är medlem i gruppen Inbyggda administratörer tilldelas du två åtkomsttoken för körning: en standardåtkomsttoken för användare och en administratörsåtkomsttoken. Som standard är du i standardanvändarrollen. Om du vill köra koden som kommer åt säkerhetsloggen måste du först höja dina autentiseringsuppgifter från standardanvändare till administratör. Du kan göra detta när du startar ett program genom att öppna snabbmenyn för programmet (om du använder en mus högerklickar du på programikonen) och anger att du vill köra som administratör.

Du kan använda EventLog för att skapa anpassade händelseloggar som du kan visa via serverns Zobrazovač udalostí. Använd metoden RegisterDisplayName för att visa ett lokaliserat namn för händelseloggen i Zobrazovač udalostí. ModifyOverflowPolicy Använd metoden för att konfigurera beteendet för händelseloggen när den når sin maximala loggstorlek.

Om du vill läsa från en händelselogg anger du loggnamnet (Log egenskapen) och serverdatornamnet (MachineName egenskapen för händelseloggen. Om du inte anger serverdatornamnet antas den lokala datorn ,. Det är inte nödvändigt att ange händelsekällan (Source egenskapen), eftersom en källa endast krävs för att skriva till loggar. Egenskapen Entries fylls automatiskt i med händelseloggens lista över poster.

Om du vill skriva till en händelselogg anger eller skapar du en händelsekälla (Source egenskap). Du måste ha administrativa autentiseringsuppgifter på datorn för att skapa en ny händelsekälla. Händelsekällan registrerar ditt program med händelseloggen som en giltig källa för poster. Du kan bara skriva till en logg i taget med händelsekällan. Egenskapen Source kan vara valfri slumpmässig sträng, men namnet måste skilja sig från andra källor på datorn. Händelsekällan är vanligtvis namnet på programmet eller en annan identifierande sträng. När du försöker skapa ett duplicerat Source värde genereras ett undantag. En enskild händelselogg kan dock associeras med flera källor.

Om händelsekällan för händelseloggen som är associerad med instansen EventLog inte finns skapas en ny händelsekälla. Om du vill skapa en händelsekälla i Windows Vista och senare eller Windows Server 2003 måste du ha administrativa autentiseringsuppgifter.

Det här kravet beror på att alla händelseloggar, inklusive säkerhetsloggar, måste genomsökas för att avgöra om händelsekällan är unik. Från och med Windows Vista har användarna inte behörighet att komma åt säkerhetsloggen. Därför utlöses en SecurityException.

Program och tjänster ska skriva till programloggen eller till en anpassad logg. Enhetsdrivrutiner bör skriva till systemloggen. Om du inte uttryckligen Log anger egenskapen, är händelseloggen som standard programloggen.

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 konfiguration. 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 ett EventLogInstaller objekt eller CreateEventSource en metod. Du måste ha administrativa autentiseringsuppgifter på datorn för att skapa en ny händelsekälla.

Varje källa kan bara skriva till en händelselogg i taget. Ditt program kan dock använda flera källor för att skriva till flera händelseloggar. Ditt program kan till exempel kräva flera källor som konfigurerats för olika händelseloggar eller olika resursfiler. Om du vill ändra konfigurationsinformationen för en befintlig källa måste du ta bort källan och sedan skapa den med den nya konfigurationen. Om andra program eller komponenter använder den befintliga källan skapar du en ny källa med den uppdaterade konfigurationen i stället för att ta bort den befintliga källan.

Du kan registrera händelsekällan med lokaliserade resurser för din händelsekategori och meddelandesträngar. Ditt program kan skriva händelseloggposter med hjälp av resursidentifierare i stället för att ange de faktiska strängvärdena. Mer information om hur du konfigurerar källan med resursfiler finns i EventLogInstaller klasserna och EventSourceCreationData .

Om ditt program skriver strängvärden direkt till händelseloggen behöver du inte ange resursfilegenskaperna för källan. 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 sedan en annan källa utan resursfiler och använd den WriteEntry källan i metoden för att skriva strängar direkt till händelseloggen med den källan.

När du skriver händelser måste du minst ange antingen en meddelandesträng eller resursidentifieraren för en meddelandesträng. Andra händelseegenskaper är valfria. Exempel på valfria händelseinställningar är följande:

• Du kan ange EventLogEntryType för att ange ikonen som Zobrazovač udalostí visar för posten.

• Du kan ange en kategoriidentifierare för händelsen, om ditt program använder kategorier för att filtrera händelserna.

• Du kan koppla binära data till händelseposten om du vill associera ytterligare information med en viss händelse.

En lista över initiala egenskapsvärden för en instans av EventLogfinns i EventLog konstruktorn.

Se även

• EventLogInstaller
• EventLogEntry
• EntryWrittenEventArgs
• ServiceBase