EventLog Klasse

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

Vererbung

Object

MarshalByRefObject

Component

EventLog

Implementiert

ISupportInitialize

Beispiele

Im folgenden Beispiel wird die Ereignisquelle MySource erstellt, sofern sie noch nicht vorhanden ist, und ein Eintrag in das Ereignisprotokoll MyNewLoggeschrieben.

#using <System.dll>

using namespace System;
using namespace System::Diagnostics;
using namespace System::Threading;
int 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( "CreatingEventSource" );
      // The source is created.  Exit the application to allow it to be registered.
      return 0;
   }

   
   // Create an EventLog instance and assign its source.
   EventLog^ myLog = gcnew EventLog;
   myLog->Source = "MySource";
   
   // Write an informational entry to the event log.    
   myLog->WriteEntry( "Writing to event log." );
}

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

Hinweise

EventLog ermöglicht ihnen den Zugriff auf oder das Anpassen von Windows-Ereignisprotokollen, die Informationen zu wichtigen Software- oder Hardwareereignissen aufzeichnen. Mit EventLogkönnen Sie aus vorhandenen Protokollen lesen, Einträge in Protokolle schreiben, Ereignisquellen erstellen oder löschen, Protokolle löschen und auf Protokolleinträge reagieren. Sie können auch neue Protokolle erstellen, wenn Sie eine Ereignisquelle erstellen.

Zusätzlich zum Zugriff auf einzelne Ereignisprotokolle und deren Einträge ermöglicht die EventLog -Klasse den Zugriff auf die Sammlung aller Ereignisprotokolle. Sie können die static Member von EventLog verwenden, um Protokolle zu löschen, Protokolllisten abzurufen, eine Quelle zu erstellen oder zu löschen oder zu bestimmen, ob ein Computer bereits eine bestimmte Quelle enthält.

Es gibt drei Standardereignisprotokolle: Application, System und Security. Ein Sicherheitsprotokoll ist schreibgeschützt. Andere Anwendungen und Dienste, die Sie installieren, z. B. Active Directory, verfügen möglicherweise über zusätzliche Ereignisprotokolle.

Bei der Verwendung der EventLog -Klasse gibt es Sicherheitsüberlegungen. EventLogerfordert EventLogPermission Berechtigungen für bestimmte Aktionen in .NET Framework 2.0 und höheren Versionen oder volle Vertrauenswürdigkeiten für die .NET Framework 1.0 und 1.1. Es wird empfohlen, teilweise EventLogPermission vertrauenswürdigen Code nicht zu gewähren. Sie sollten kein Ereignisprotokollobjekt, einschließlich EventLogEntryCollection und EventLogEntry -Objekte, an weniger vertrauenswürdigen Code übergeben. Beispielsweise kann das Erstellen eines EventLog Objekts, das Schreiben eines Eintrags und die anschließende Übergabe des EventLog Objekts an teilweise vertrauenswürdigen Code zu einem Sicherheitsproblem führen, da die Möglichkeit, das Ereignisprotokoll zu lesen und in das Ereignisprotokoll zu schreiben, Aktionen wie das Ausgeben von Ereignisprotokollmeldungen im Namen einer anderen Anwendung ermöglicht.

Ab Windows Vista bestimmt die Benutzerkontensteuerung (UAC) die Anmeldeinformationen eines Benutzers. Als Mitglied der integrierten Administratorgruppe sind Ihnen zwei Zugriffstoken für die Laufzeit zugewiesen: ein Standardbenutzertoken und ein Administratorzugriffstoken. Standardmäßig verwenden Sie die Standardbenutzerrolle. Um den Code auszuführen, der auf das Sicherheitsprotokoll zugreift, müssen Sie zuerst Ihre Anmeldeinformationen vom Standardbenutzer zum Administrator erhöhen. Sie können dies tun, wenn Sie eine Anwendung starten, indem Sie das Kontextmenü für die Anwendung öffnen (wenn Sie eine Maus verwenden, klicken Sie mit der rechten Maustaste auf das Anwendungssymbol), und geben Sie an, dass Sie als Administrator ausführen möchten.

Sie können verwendenEventLog, um benutzerdefinierte Ereignisprotokolle zu erstellen, die Sie über die Ereignisanzeige des Servers anzeigen können. Verwenden Sie die RegisterDisplayName -Methode, um einen lokalisierten Namen für Ihr Ereignisprotokoll im Ereignisanzeige anzuzeigen. Verwenden Sie die ModifyOverflowPolicy -Methode, um das Verhalten Ihres Ereignisprotokolls zu konfigurieren, wenn es seine maximale Protokollgröße erreicht.

Um aus einem Ereignisprotokoll zu lesen, geben Sie den Protokollnamen (Log Eigenschaft) und den Servercomputernamen (MachineName - Eigenschaft für das Ereignisprotokoll an. Wenn Sie den Namen des Servercomputers nicht angeben, wird der lokale Computer "." angenommen. Es ist nicht erforderlich, die Ereignisquelle (Source -Eigenschaft) anzugeben, da eine Quelle nur zum Schreiben in Protokolle erforderlich ist. Die Entries -Eigenschaft wird automatisch mit der Liste der Einträge des Ereignisprotokolls aufgefüllt.

Um in ein Ereignisprotokoll zu schreiben, geben Sie eine Ereignisquelle an , oder erstellen Sie sie (Source -Eigenschaft). Sie müssen über Administratoranmeldeinformationen auf dem Computer verfügen, um eine neue Ereignisquelle erstellen zu können. Die Ereignisquelle registriert Ihre Anwendung beim Ereignisprotokoll als gültige Quelle von Einträgen. Sie können die Ereignisquelle verwenden, um jeweils nur in ein Protokoll zu schreiben. Die Source Eigenschaft kann eine beliebige zufällige Zeichenfolge sein, aber der Name muss sich von anderen Quellen auf dem Computer unterscheiden. Die Ereignisquelle ist in der Regel der Name der Anwendung oder eine andere identifizierende Zeichenfolge. Beim Versuch, einen doppelten Source Wert zu erstellen, wird eine Ausnahme ausgelöst. Ein einzelnes Ereignisprotokoll kann jedoch mehreren Quellen zugeordnet werden.

Wenn die Ereignisquelle für das Ereignisprotokoll, das dem EventLog instance zugeordnet ist, nicht vorhanden ist, wird eine neue Ereignisquelle erstellt. Zum Erstellen einer Ereignisquelle in Windows Vista und höher oder Windows Server 2003 müssen Sie über Administratoranmeldeinformationen verfügen.

Diese Anforderung liegt daran, dass alle Ereignisprotokolle, einschließlich sicherheitsrelevanter Protokolle, durchsucht werden müssen, um festzustellen, ob die Ereignisquelle eindeutig ist. Ab Windows Vista haben Benutzer keine Berechtigung, auf das Sicherheitsprotokoll zuzugreifen. daher wird ein SecurityException ausgelöst.

Anwendungen und Dienste sollten in das Anwendungsprotokoll oder in ein benutzerdefiniertes Protokoll schreiben. Gerätetreiber sollten in das Systemprotokoll schreiben. Wenn Sie die Log -Eigenschaft nicht explizit festlegen, wird das Ereignisprotokoll standardmäßig auf das Anwendungsprotokoll festgelegt.

Verwenden Sie die WriteEvent Methoden und WriteEntry , um Ereignisse in ein Ereignisprotokoll zu schreiben. Sie müssen eine Ereignisquelle angeben, um Ereignisse zu schreiben. Sie müssen die Ereignisquelle erstellen und konfigurieren, bevor Sie den ersten Eintrag mit der Quelle schreiben.

Create die neue Ereignisquelle während der Installation Ihrer Anwendung. Dadurch kann das Betriebssystem die Liste der registrierten Ereignisquellen und deren Konfiguration aktualisieren. Wenn das Betriebssystem die Liste der Ereignisquellen nicht aktualisiert hat und Sie versuchen, ein Ereignis mit der neuen Quelle zu schreiben, schlägt der Schreibvorgang fehl. Sie können eine neue Quelle mithilfe eines EventLogInstaller -Objekts oder der CreateEventSource -Methode konfigurieren. Sie müssen über Administratoranmeldeinformationen auf dem Computer verfügen, um eine neue Ereignisquelle erstellen zu können.

Jede Quelle kann jeweils nur in ein Ereignisprotokoll schreiben. Ihre Anwendung kann jedoch mehrere Quellen verwenden, um in mehrere Ereignisprotokolle zu schreiben. Beispielsweise erfordert Ihre Anwendung möglicherweise mehrere Quellen, die für unterschiedliche Ereignisprotokolle oder unterschiedliche Ressourcendateien konfiguriert sind. Um die Konfigurationsdetails einer vorhandenen Quelle zu ändern, müssen Sie die Quelle löschen und dann mit der neuen Konfiguration erstellen. Wenn andere Anwendungen oder Komponenten die vorhandene Quelle verwenden, erstellen Sie eine neue Quelle mit der aktualisierten Konfiguration, anstatt die vorhandene Quelle zu löschen.

Sie können die Ereignisquelle mit lokalisierten Ressourcen für Ihre Ereigniskategorie und Nachrichtenzeichenfolgen registrieren. Ihre Anwendung kann Ereignisprotokolleinträge mithilfe von Ressourcenbezeichnern schreiben, anstatt die tatsächlichen Zeichenfolgenwerte anzugeben. Weitere Informationen zum Konfigurieren ihrer Quelle mit Ressourcendateien finden Sie in den EventLogInstaller Klassen und EventSourceCreationData .

Wenn Ihre Anwendung Zeichenfolgenwerte direkt in das Ereignisprotokoll schreibt, müssen Sie die Eigenschaften der Ressourcendatei für die Quelle nicht festlegen. Die Quelle muss entweder zum Schreiben lokalisierter Einträge oder zum Schreiben direkter Zeichenfolgen konfiguriert werden. Wenn Ihre Anwendung Einträge mit Ressourcenbezeichnern und Zeichenfolgenwerten schreibt, müssen Sie zwei separate Quellen registrieren. Konfigurieren Sie beispielsweise eine Quelle mit Ressourcendateien, und verwenden Sie diese Quelle dann in der WriteEvent -Methode, um Einträge mithilfe von Ressourcenbezeichnern in das Ereignisprotokoll zu schreiben. Erstellen Sie dann eine andere Quelle ohne Ressourcendateien, und verwenden Sie diese Quelle in der WriteEntry -Methode, um Zeichenfolgen mithilfe dieser Quelle direkt in das Ereignisprotokoll zu schreiben.

Beim Schreiben von Ereignissen müssen Sie mindestens eine Nachrichtenzeichenfolge oder den Ressourcenbezeichner für eine Nachrichtenzeichenfolge angeben. Andere Ereigniseigenschaften sind optional. Beispiele für optionale Ereigniseinstellungen sind:

• Sie können festlegenEventLogEntryType, um das Symbol anzugeben, das vom Ereignisanzeige für den Eintrag angezeigt wird.

• Sie können einen Kategoriebezeichner für das Ereignis angeben, wenn Ihre Anwendung Kategorien zum Filtern der Ereignisse verwendet.

• Sie können Binärdaten an Ihren Ereigniseintrag anfügen, wenn Sie einem bestimmten Ereignis zusätzliche Informationen zuordnen möchten.

Eine Liste der anfänglichen Eigenschaftswerte für eine instance von EventLogfinden Sie im EventLog Konstruktor.

Konstruktoren

Eigenschaften

Methoden

Ereignisse

Gilt für:

Weitere Informationen

• EventLogInstaller
• EventLogEntry
• EntryWrittenEventArgs
• ServiceBase