Freigeben über


EventLog-Konstruktor (String, String, String)

Initialisiert eine neue Instanz der EventLog-Klasse. Ordnet die Instanz einem Protokoll auf dem angegebenen Computer zu und erstellt die angegebene Quelle bzw. weist diese dem EventLog zu.

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

Syntax

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

Dim instance As New EventLog(logName, machineName, source)
public EventLog (
    string logName,
    string machineName,
    string source
)
public:
EventLog (
    String^ logName, 
    String^ machineName, 
    String^ source
)
public EventLog (
    String logName, 
    String machineName, 
    String source
)
public function EventLog (
    logName : String, 
    machineName : String, 
    source : String
)

Parameter

  • logName
    Der Name des Protokolls auf dem angegebenen Computer.
  • machineName
    Der Computer, auf dem das Protokoll vorhanden ist.
  • source
    Die Quelle für Ereignisprotokolleinträge.

Ausnahmen

Ausnahmetyp Bedingung

ArgumentNullException

Der Protokollname ist NULL (Nothing in Visual Basic).

ArgumentException

Der Protokollname ist ungültig.

– oder –

Der Computername ist ungültig.

Hinweise

Dieser Konstruktor legt die Log-Eigenschaft auf den logName-Parameter, die MachineName-Eigenschaft auf den machineName-Parameter und die Source-Eigenschaft auf den source-Parameter fest. Die Source-Eigenschaft ist für das Schreiben in ein Ereignisprotokoll erforderlich. Wenn Sie jedoch nur aus einem Ereignisprotokoll lesen, sind nur die Log-Eigenschaft und die MachineName-Eigenschaft erforderlich, vorausgesetzt, dass dem Ereignisprotokoll auf dem Server bereits eine Quelle zugeordnet ist. Wenn Sie nur aus dem Ereignisprotokoll lesen, ist eine weitere Überladung des Konstruktors möglicherweise ausreichend.

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

Eigenschaft

Anfangswert

Source

Der source-Parameter.

Log

Der logName-Parameter.

MachineName

Der machineName-Parameter.

Beispiel

Im folgenden Beispiel wird mithilfe der Quelle "MySource" ein Eintrag in das Ereignisprotokoll "MyNewLog" auf dem lokalen Computer geschrieben.

Option Strict
Option Explicit

Imports System
Imports System.Diagnostics
Imports System.Threading

Class MySample
    Public Shared Sub Main()
        
        ' Create an EventLog instance and assign its source.
        Dim myLog As New EventLog("myNewLog", ".", "MySource")
        
        ' Write an entry to the log.        
        myLog.WriteEntry(("Writing to event log on " & myLog.MachineName))
    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 source.
        EventLog myLog = new EventLog("myNewLog", ".", "MySource");

        // Write an entry to the log.        
        myLog.WriteEntry("Writing to event log on " + myLog.MachineName);

    }
}
   
#using <System.dll>

using namespace System;
using namespace System::Diagnostics;
using namespace System::Threading;
int main()
{
   
   // Create an EventLog instance and assign its source.
   EventLog^ myLog = gcnew EventLog( "myNewLog",".","MySource" );
   
   // Write an entry to the log.        
   myLog->WriteEntry( String::Format( "Writing to event log on {0}", myLog->MachineName ) );
}
import System.*;
import System.Diagnostics.*;
import System.Threading.*;

class MySample
{
    public static void main(String[] args)
    {
        // Create an EventLog instance and assign its source.
        EventLog myLog = new EventLog("myNewLog", ".", "MySource");
        // Write an entry to the log.        
        myLog.WriteEntry("Writing to event log on " 
            + myLog.get_MachineName());
    } //main 
} //MySample

.NET Framework-Sicherheit

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