EventLog Konstruktory

Definice

Obor názvů:

System.Diagnostics

Sestavení:

System.Diagnostics.EventLog.dll

Balíček:

System.Diagnostics.EventLog v8.0.0

Inicializuje novou instanci EventLog třídy .

Přetížení

EventLog()	Inicializuje novou instanci EventLog třídy . Nepřidruží instanci k žádnému protokolu.
EventLog(String)	Inicializuje novou instanci EventLog třídy . Přidruží instanci k protokolu v místním počítači.
EventLog(String, String)	Inicializuje novou instanci EventLog třídy . Přidruží instanci k protokolu v zadaném počítači.
EventLog(String, String, String)	Inicializuje novou instanci EventLog třídy . Přidruží instanci k protokolu v zadaném počítači a vytvoří nebo přiřadí zadaný zdroj k EventLog.

EventLog()

Zdroj:

EventLog.cs

Inicializuje novou instanci EventLog třídy . Nepřidruží instanci k žádnému protokolu.

public:
 EventLog();

public EventLog ();

Public Sub New ()

Příklady

Následující příklad vytvoří zdroj MySource , pokud ještě neexistuje, a zapíše položku do protokolu MyNewLogudálostí .

#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

Poznámky

Před voláním WriteEntrySource zadejte vlastnost EventLog instance. Pokud pouze čtete Entries z protokolu, můžete alternativně zadat pouze Log vlastnosti a MachineName .

Poznámka

Pokud nezadáte MachineName, předpokládá se místní počítač (".").

Následující tabulka uvádí počáteční hodnoty vlastností pro instanci .EventLog

Vlastnost	Počáteční hodnota
Source	Prázdný řetězec ("").
Log	Prázdný řetězec ("").
MachineName	Místní počítač (".").

Viz také

• Source
• Log
• MachineName
• Entries
• WriteEntry
• WriteEvent
• EventLogEntry

EventLog(String)

Zdroj:

EventLog.cs

Inicializuje novou instanci EventLog třídy . Přidruží instanci k protokolu v místním počítači.

public:
 EventLog(System::String ^ logName);

public EventLog (string logName);

new System.Diagnostics.EventLog : string -> System.Diagnostics.EventLog

Public Sub New (logName As String)

Parametry

logName

String

Název protokolu v místním počítači.

Výjimky

ArgumentNullException

Název protokolu je null.

ArgumentException

Název protokolu je neplatný.

Příklady

Následující příklad přečte položky v protokolu událostí "myNewLog" v místním počítači.

#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 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 );
   }
}

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 log name.
        EventLog myLog = new EventLog("myNewLog");

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

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

        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
End Class

Poznámky

Toto přetížení nastaví Log vlastnost na logName parametr . Před voláním WriteEntrySource zadejte vlastnost EventLog instance. Pokud pouze čtete Entries z protokolu, můžete alternativně zadat pouze Log vlastnosti a MachineName .

Poznámka

Pokud nezadáte MachineName, předpokládá se místní počítač ("."). Toto přetížení konstruktoru určuje Log vlastnost , ale před čtením Entries vlastnosti ji můžete změnit.

Pokud zdroj, který zadáte ve Source vlastnosti, je jedinečný z jiných zdrojů v počítači, následné volání WriteEntry vytvoří protokol se zadaným názvem, pokud ještě neexistuje.

Následující tabulka uvádí počáteční hodnoty vlastností pro instanci .EventLog

Vlastnost	Počáteční hodnota
Source	Prázdný řetězec ("").
Log	Parametr .logName
MachineName	Místní počítač (".").

Viz také

• Source
• Log
• MachineName
• Entries
• WriteEntry
• WriteEvent
• EventLogEntry

EventLog(String, String)

Zdroj:

EventLog.cs

Inicializuje novou instanci EventLog třídy . Přidruží instanci k protokolu v zadaném počítači.

public:
 EventLog(System::String ^ logName, System::String ^ machineName);

public EventLog (string logName, string machineName);

new System.Diagnostics.EventLog : string * string -> System.Diagnostics.EventLog

Public Sub New (logName As String, machineName As String)

Parametry

logName

String

Název protokolu v zadaném počítači.

machineName

String

Počítač, na kterém se protokol nachází.

Výjimky

ArgumentNullException

Název protokolu je null.

ArgumentException

Název protokolu je neplatný.

-nebo-

Název počítače je neplatný.

Příklady

Následující příklad přečte položky v protokolu událostí myNewLog na počítači myServer.

#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", "myServer" );
      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 log name.
   EventLog^ myLog = gcnew EventLog( "myNewLog","myServer" );
   
   // 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 );
   }
}

using System;
using System.Diagnostics;
using System.Threading;

class MySample1
{
    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", "myServer");
            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 log name.
        EventLog myLog = new EventLog("myNewLog", "myServer");

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

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", "myServer")
            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 log name.
        Dim myLog As New EventLog("myNewLog", "myServer")
        
        ' 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
End Class

Poznámky

Toto přetížení nastaví Log vlastnost na logName parametr a MachineName vlastnost na machineName parametr. Před voláním WriteEntrySource zadejte vlastnost objektu EventLog. Pokud pouze čtete Entries z protokolu, můžete alternativně zadat pouze Log vlastnosti a MachineName .

Poznámka

Toto přetížení konstruktoru určuje Log vlastnosti a MachineName , ale před čtením vlastnosti můžete některou z Entries těchto vlastností změnit.

Následující tabulka uvádí počáteční hodnoty vlastností pro instanci .EventLog

Vlastnost	Počáteční hodnota
Source	Prázdný řetězec ("").
Log	Parametr .logName
MachineName	Parametr .machineName

Viz také

• Source
• Log
• MachineName
• Entries
• WriteEntry
• WriteEvent
• EventLogEntry

EventLog(String, String, String)

Zdroj:

EventLog.cs

Inicializuje novou instanci EventLog třídy . Přidruží instanci k protokolu v zadaném počítači a vytvoří nebo přiřadí zadaný zdroj k EventLog.

public:
 EventLog(System::String ^ logName, System::String ^ machineName, System::String ^ source);

public EventLog (string logName, string machineName, string source);

new System.Diagnostics.EventLog : string * string * string -> System.Diagnostics.EventLog

Public Sub New (logName As String, machineName As String, source As String)

Parametry

logName

String

Název protokolu v zadaném počítači.

machineName

String

Počítač, na kterém se protokol nachází.

source

String

Zdroj položek protokolu událostí.

Výjimky

ArgumentNullException

Název protokolu je null.

ArgumentException

Název protokolu je neplatný.

-nebo-

Název počítače je neplatný.

Příklady

Následující příklad zapíše záznam do protokolu událostí "MyNewLog" v místním počítači pomocí zdroje "MySource".

#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( "myNewLog",".","MySource" );
   
   // Write an entry to the log.        
   myLog->WriteEntry( String::Format( "Writing to event log on {0}", myLog->MachineName ) );
}

using System;
using System.Diagnostics;
using System.Threading;

class MySample2
{
    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("myNewLog", ".", "MySource");

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

Option Strict
Option Explicit

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("myNewLog", ".", "MySource")
        
        ' Write an entry to the log.        
        myLog.WriteEntry(("Writing to event log on " & myLog.MachineName))
    End Sub
End Class

Poznámky

Tento konstruktor nastaví Log vlastnost parametru MachineNamelogName, vlastnost parametru machineName a Source vlastnost parametrusource. Vlastnost Source se vyžaduje při zápisu do protokolu událostí. Pokud ale čtete jenom z protokolu událostí, vyžadují se pouze Log vlastnosti a MachineName (pokud je k protokolu událostí na serveru již přidružený zdroj). Pokud pouze čtete z protokolu událostí, může stačit další přetížení konstruktoru.

Následující tabulka uvádí počáteční hodnoty vlastností pro instanci .EventLog

Vlastnost	Počáteční hodnota
Source	Parametr .source
Log	Parametr .logName
MachineName	Parametr .machineName

Viz také

• Source
• Log
• MachineName
• Entries
• WriteEntry
• WriteEvent
• EventLogEntry