EventLog.Entries-Eigenschaft

Ruft den Inhalt des Ereignisprotokolls ab.

Namespace: System.Diagnostics
Assembly: System (in system.dll)

Syntax

'Declaration
Public ReadOnly Property Entries As EventLogEntryCollection
'Usage
Dim instance As EventLog
Dim value As EventLogEntryCollection

value = instance.Entries

public EventLogEntryCollection Entries { get; }

public:
property EventLogEntryCollection^ Entries {
    EventLogEntryCollection^ get ();
}

/** @property */
public EventLogEntryCollection get_Entries ()

public function get Entries () : EventLogEntryCollection

Eigenschaftenwert

Eine EventLogEntryCollection mit den Einträgen im Ereignisprotokoll. Jeder Eintrag ist einer Instanz der EventLogEntry-Klasse zugeordnet.

Hinweise

Verwenden Sie den Entries-Member zum Lesen aus dem Ereignisprotokoll.

Da diese Eigenschaft schreibgeschützt ist, können Sie keine Einträge bearbeiten oder mit Entries in das Protokoll schreiben. Geben Sie stattdessen eine Source an, und rufen Sie WriteEntry auf, um einen neuen Protokolleintrag zu schreiben. Mit Entries können Sie die Anzahl der Einträge im Ereignisprotokoll zählen und jeden EventLogEntry in der Auflistung anzeigen lassen. Verwenden Sie den indizierten Item-Member, um Informationen über einen bestimmten Eintrag abzurufen, z. B. Message, Category, TimeWritten oder EntryType.

Es ist nicht erforderlich, eine Source anzugeben, wenn aus einem Protokoll nur gelesen wird. Sie können für die EventLog-Instanz auch nur die Log-Namenseigenschaft und die MachineName-Eigenschaft (Name des Servercomputers) angeben. In beiden Fällen wird der Entries-Member automatisch mit der Liste der Einträge des Ereignisprotokolls aufgefüllt. Sie können den entsprechenden Index für ein Element in der Liste auswählen, um einzelne Einträge zu lesen.

Ein wichtiger Unterschied zwischen Lesen und Schreiben von Protokolleinträgen besteht darin, dass eine Read-Methode nicht explizit aufgerufen werden muss. Nachdem Log und MachineName angegeben wurden, wird die Entries-Eigenschaft automatisch aufgefüllt. Wenn Sie den Wert der Log-Eigenschaft oder der MachineName-Eigenschaft ändern, wird die Entries-Eigenschaft beim nächsten Lesevorgang erneut aufgefüllt.

Beispiel

Im folgenden Beispiel werden Einträge aus dem Ereignisprotokoll "MyNewLog" auf dem lokalen Computer gelesen.

Option Strict
Option Explicit

Imports System
Imports System.Diagnostics
Imports Microsoft.VisualBasic

Class MySample
    Public Shared Sub Main()
        
        Dim myLog As New EventLog()
        myLog.Log = "MyNewLog"
        Dim entry As EventLogEntry
        For Each entry In  myLog.Entries
            Console.WriteLine((ControlChars.Tab & "Entry: " & entry.Message))
        Next entry
    End Sub ' Main
End Class ' MySample

using System;
using System.Diagnostics;
              
class MySample{

    public static void Main(){

        EventLog myLog = new EventLog();
        myLog.Log = "MyNewLog";                      
        foreach(EventLogEntry entry in myLog.Entries){
            Console.WriteLine("\tEntry: " + entry.Message);
        }    
    }       
}
   

#using <System.dll>

using namespace System;
using namespace System::Diagnostics;
int main()
{
   EventLog^ myLog = gcnew EventLog;
   myLog->Log = "MyNewLog";
   System::Collections::IEnumerator^ myEnum = myLog->Entries->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      EventLogEntry^ entry = safe_cast<EventLogEntry^>(myEnum->Current);
      Console::WriteLine( "\tEntry: {0}", entry->Message );
   }
}

import System.*;
import System.Diagnostics.*;
import System.Collections.*;

class MySample
{
    public static void main(String[] args)
    {
        EventLog myLog = new EventLog();
        myLog.set_Log("MyNewLog");
        EventLogEntry entry;
        IEnumerator objEnum = myLog.get_Entries().GetEnumerator();
        while (objEnum.MoveNext()) {
            entry = (EventLogEntry)objEnum.get_Current();
            Console.WriteLine("\tEntry: " + entry.get_Message());
        }
    } //main
} //MySample

.NET Framework-Sicherheit

• EventLogPermission  für das Verwalten von Ereignisprotokollinformationen auf dem Computer. Zugeordnete Enumeration: EventLogPermissionAccess.Administer

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

EventLog-Klasse
EventLog-Member
System.Diagnostics-Namespace
EventLogEntryCollection
EventLogEntry
Source
Log
MachineName
WriteEntry