EventLog-Konstruktor (String)

Initialisiert eine neue Instanz der EventLog-Klasse. Ordnet die Instanz einem Protokoll auf dem lokalen Computer zu.

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

Syntax

'Declaration
Public Sub New ( _
    logName As String _
)
'Usage
Dim logName As String

Dim instance As New EventLog(logName)

public EventLog (
    string logName
)

public:
EventLog (
    String^ logName
)

public EventLog (
    String logName
)

public function EventLog (
    logName : String
)

Parameter

• logName
  Der Name des Protokolls auf dem lokalen Computer.

Ausnahmen

Ausnahmetyp	Bedingung
ArgumentNullException	Der Protokollname ist NULL (Nothing in Visual Basic).
ArgumentException	Der Protokollname ist ungültig.

Hinweise

Diese Überladung legt die Log-Eigenschaft auf den logName-Parameter fest. Geben Sie vor dem Aufruf von WriteEntry die Source-Eigenschaft der EventLog-Instanz an. Wenn Sie Entries nur aus dem Protokoll lesen, müssen Sie nur die Log-Eigenschaft und die MachineName-Eigenschaft angeben.

Hinweis

Wenn Sie keinen MachineName angeben, wird der lokale Computer (".") verwendet. Diese Überladung des Konstruktors gibt die Log-Eigenschaft an. Sie können diese jedoch vor dem Lesen der Entries-Eigenschaft ändern.

Wenn sich die in der Source-Eigenschaft angegebene Quelle eindeutig von anderen Quellen auf dem Computer unterscheidet, wird durch einen nachfolgenden Aufruf von WriteEntry ein Protokoll mit dem angegebenen Namen erstellt, sofern dieses nicht bereits vorhanden ist.

In der folgenden Tabelle werden die anfänglichen Eigenschaftenwerte für eine Instanz von EventLog aufgeführt.

Eigenschaft	Anfangswert
Source	Eine leere Zeichenfolge ("").
Log	Der logName-Parameter.
MachineName	Der lokale Computer (".").

Beispiel

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

Option Explicit
Option Strict

Imports System
Imports System.Diagnostics
Imports System.Threading
Imports Microsoft.VisualBasic

Class MySample
    Public Shared Sub Main()
        
        ' Create an EventLog instance and assign its log name.
        Dim myLog As New EventLog("myNewLog")
        
        ' Read the event log entries.
        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;
using System.Threading;
              
class MySample{


    public static void Main(){
           
                        
        // Create an EventLog instance and assign its log name.
        EventLog myLog = new EventLog("myNewLog");

        // Read the event log entries.
        foreach(EventLogEntry entry in myLog.Entries){
            Console.WriteLine("\tEntry: " + entry.Message);
        }                                                                     
    }
}
   

#using <System.dll>

using namespace System;
using namespace System::Diagnostics;
using namespace System::Threading;
int main()
{
   
   // Create an EventLog instance and assign its log name.
   EventLog^ myLog = gcnew EventLog( "myNewLog" );
   
   // Read the event log entries.
   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.Threading.*;

class MySample
{
    public static void main(String[] args)
    {
        // Create an EventLog instance and assign its log name.
        EventLog myLog = new EventLog("myNewLog");

        // Read the event log entries.
        for (int iCtr = 0; iCtr < myLog.get_Entries().get_Count(); iCtr++) {
            EventLogEntry entry = myLog.get_Entries().get_Item(iCtr);
            Console.WriteLine("\tEntry: " + entry.get_Message());
        }
    } //main
} //MySample

.NET Framework-Sicherheit

• EventLogPermission  zum Schreiben von Ereignisprotokollinformationen auf dem Computer. Zugeordnete Enumeration: EventLogPermissionAccess.Write

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
Source
Log
MachineName
Entries
WriteEntry
WriteEvent
EventLogEntry