EventLog Klas

Definitie

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

Overname

Object

MarshalByRefObject

Component

EventLog

Implementeringen

ISupportInitialize

Voorbeelden

In het volgende voorbeeld wordt de gebeurtenisbron MySource gemaakt als deze nog niet bestaat en wordt een vermelding naar het gebeurtenislogboek MyNewLoggeschreven.

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

Opmerkingen

EventLog kunt u Windows gebeurtenislogboeken openen of aanpassen, waarmee informatie over belangrijke software- of hardware-gebeurtenissen wordt vastgelegd. Met behulp van EventLog, kunt u lezen uit bestaande logboeken, vermeldingen naar logboeken schrijven, gebeurtenisbronnen maken of verwijderen, logboeken verwijderen en reageren op logboekvermeldingen. U kunt ook nieuwe logboeken maken bij het maken van een gebeurtenisbron.

Naast het bieden van toegang tot afzonderlijke gebeurtenislogboeken en de bijbehorende vermeldingen, kunt u met de EventLog klasse toegang krijgen tot de verzameling van alle gebeurtenislogboeken. U kunt de leden van EventLog de static groep gebruiken om logboeken te verwijderen, logboeklijsten op te halen, een bron te maken of te verwijderen of te bepalen of een computer al een bepaalde bron bevat.

Er zijn drie standaard gebeurtenislogboeken: Toepassing, Systeem en Beveiliging. Een beveiligingslogboek heeft het kenmerk Alleen-lezen. Andere toepassingen en services die u installeert, zoals Active Directory, kunnen extra gebeurtenislogboeken bevatten.

Er zijn beveiligingsoverwegingen bij het gebruik van de EventLog klasse. EventLog vereist EventLogPermission machtigingen voor specifieke acties. U wordt aangeraden niet EventLogPermission te worden verleend aan gedeeltelijk vertrouwde code. U moet nooit een gebeurtenislogboekobject, inclusief EventLogEntryCollection en EventLogEntry objecten, doorgeven aan minder vertrouwde code. Als u bijvoorbeeld een EventLog object maakt, een vermelding schrijft en het EventLog object vervolgens doorgeeft aan gedeeltelijk vertrouwde code, kan dit een beveiligingsprobleem maken, omdat de mogelijkheid om het gebeurtenislogboek te lezen en schrijven code toestaat om acties uit te voeren, zoals het uitgeven van gebeurtenislogboekberichten in de naam van een andere toepassing.

Vanaf Windows Vista bepaalt UAC (User Account Control) de referenties van een gebruiker. Als u lid bent van de groep Ingebouwde beheerders, hebt u twee runtime-toegangstokens toegewezen: een standaard toegangstoken voor gebruikers en een beheerderstoegangstoken. Standaard hebt u de standaardgebruikersrol. Als u de code wilt uitvoeren die toegang heeft tot het beveiligingslogboek, moet u eerst uw referenties verhogen van de standaardgebruiker naar de beheerder. U kunt dit doen wanneer u een toepassing start door het snelmenu voor de toepassing te openen (als u een muis gebruikt, klikt u met de rechtermuisknop op het toepassingspictogram) en geeft u aan dat u wilt uitvoeren als beheerder.

U kunt EventLog gebruiken om aangepaste gebeurtenislogboeken te maken die u kunt bekijken via de Logboeken van de server. Gebruik de methode RegisterDisplayName om een gelokaliseerde naam weer te geven voor het gebeurtenislogboek in de Logboeken. Gebruik de ModifyOverflowPolicy methode om het gedrag van uw gebeurtenislogboek te configureren wanneer deze de maximale logboekgrootte bereikt.

Als u wilt lezen uit een gebeurtenislogboek, geeft u de logboeknaam (Log eigenschap) en servercomputernaam (MachineName eigenschap voor het gebeurtenislogboek) op. Als u de servercomputernaam niet opgeeft, wordt ervan uitgegaan dat de lokale computer '.' wordt gebruikt. Het is niet nodig om de gebeurtenisbron (Source eigenschap) op te geven, omdat een bron alleen is vereist voor het schrijven naar logboeken. De Entries eigenschap wordt automatisch gevuld met de lijst met vermeldingen in het gebeurtenislogboek.

Als u naar een gebeurtenislogboek wilt schrijven, geeft u een gebeurtenisbron (Source eigenschap) op of maakt u deze. U moet beheerdersreferenties op de computer hebben om een nieuwe gebeurtenisbron te maken. De gebeurtenisbron registreert uw toepassing bij het gebeurtenislogboek als een geldige bron van vermeldingen. U kunt de gebeurtenisbron gebruiken om slechts één logboek tegelijk te schrijven. De Source eigenschap kan elke willekeurige tekenreeks zijn, maar de naam moet verschillen van andere bronnen op de computer. De gebeurtenisbron is doorgaans de naam van de toepassing of een andere identificatietekenreeks. Als u een dubbele Source waarde probeert te maken, wordt er een uitzondering gegenereerd. Er kan echter één gebeurtenislogboek worden gekoppeld aan meerdere bronnen.

Als de gebeurtenisbron voor het gebeurtenislogboek dat is gekoppeld aan het EventLog exemplaar niet bestaat, wordt er een nieuwe gebeurtenisbron gemaakt. Als u een gebeurtenisbron wilt maken in Windows Vista en hoger of Windows Server 2003, moet u beheerdersreferenties hebben.

Deze vereiste komt doordat alle gebeurtenislogboeken, inclusief beveiligingslogboeken, moeten worden doorzocht om te bepalen of de gebeurtenisbron uniek is. Vanaf Windows Vista hebben gebruikers geen toegang tot het beveiligingslogboek. Daarom wordt er een SecurityException gegenereerd.

Toepassingen en services moeten naar het toepassingslogboek of naar een aangepast logboek schrijven. Apparaatstuurprogramma's moeten naar het systeemlogboek schrijven. Als u de Log eigenschap niet expliciet instelt, wordt het gebeurtenislogboek standaard ingesteld op het toepassingslogboek.

Gebruik de WriteEvent en WriteEntry methoden om gebeurtenissen naar een gebeurtenislogboek te schrijven. U moet een gebeurtenisbron opgeven om gebeurtenissen te schrijven; u moet de gebeurtenisbron maken en configureren voordat u de eerste vermelding met de bron schrijft.

Maak de nieuwe gebeurtenisbron tijdens de installatie van uw toepassing. Hierdoor kan het besturingssysteem de lijst met geregistreerde gebeurtenisbronnen en hun configuratie vernieuwen. Als het besturingssysteem de lijst met gebeurtenisbronnen niet heeft vernieuwd en u probeert een gebeurtenis te schrijven met de nieuwe bron, mislukt de schrijfbewerking. U kunt een nieuwe bron configureren met behulp van een EventLogInstaller object of methode CreateEventSource . U moet beheerdersreferenties op de computer hebben om een nieuwe gebeurtenisbron te maken.

Elke bron kan slechts naar één gebeurtenislogboek tegelijk schrijven; Uw toepassing kan echter meerdere bronnen gebruiken om naar meerdere gebeurtenislogboeken te schrijven. Uw toepassing kan bijvoorbeeld meerdere bronnen vereisen die zijn geconfigureerd voor verschillende gebeurtenislogboeken of verschillende resourcebestanden. Als u de configuratiedetails van een bestaande bron wilt wijzigen, moet u de bron verwijderen en deze vervolgens maken met de nieuwe configuratie. Als andere toepassingen of onderdelen de bestaande bron gebruiken, maakt u een nieuwe bron met de bijgewerkte configuratie in plaats van de bestaande bron te verwijderen.

U kunt de gebeurtenisbron registreren bij gelokaliseerde resources voor uw gebeurteniscategorie en berichtreeksen. Uw toepassing kan vermeldingen in gebeurtenislogboeken schrijven met behulp van resource-id's in plaats van de werkelijke tekenreekswaarden op te geven. Raadpleeg de en EventSourceCreationData klassen voor meer informatie over het EventLogInstaller configureren van uw bron met resourcebestanden.

Als uw toepassing tekenreekswaarden rechtstreeks naar het gebeurtenislogboek schrijft, hoeft u de eigenschappen van het bronbestand niet in te stellen voor de bron. De bron moet worden geconfigureerd voor het schrijven van gelokaliseerde vermeldingen of voor het schrijven van directe tekenreeksen. Als uw toepassing vermeldingen schrijft met zowel resource-id's als tekenreekswaarden, moet u twee afzonderlijke bronnen registreren. Configureer bijvoorbeeld één bron met resourcebestanden en gebruik die bron in de WriteEvent methode om vermeldingen te schrijven met behulp van resource-id's naar het gebeurtenislogboek. Maak vervolgens een andere bron zonder resourcebestanden en gebruik die bron in de WriteEntry methode om tekenreeksen rechtstreeks naar het gebeurtenislogboek te schrijven met behulp van die bron.

Bij het schrijven van gebeurtenissen moet u ten minste een berichttekenreeks of de resource-id voor een berichttekenreeks opgeven. Andere gebeurteniseigenschappen zijn optioneel. Voorbeelden van optionele gebeurtenisinstellingen zijn:

• U kunt de EventLogEntryType instellen om het pictogram op te geven dat door het Logboeken voor de vermelding wordt weergegeven.

• U kunt een categorie-id voor de gebeurtenis opgeven als uw toepassing categorieën gebruikt voor het filteren van de gebeurtenissen.

• U kunt binaire gegevens aan uw gebeurtenisvermelding koppelen als u aanvullende informatie wilt koppelen aan een bepaalde gebeurtenis.

Zie de EventLog constructor voor een lijst met initiële eigenschapswaarden voor een exemplaar vanEventLog.

Zie ook

• EventLogInstaller
• EventLogEntry
• EntryWrittenEventArgs
• ServiceBase