EventLog.LogNameFromSourceName(String, String) Methode

Definition

Ruft den Namen des Protokolls ab, in der die angegebene Quelle registriert ist.

public:
 static System::String ^ LogNameFromSourceName(System::String ^ source, System::String ^ machineName);
public static string LogNameFromSourceName (string source, string machineName);
static member LogNameFromSourceName : string * string -> string
Public Shared Function LogNameFromSourceName (source As String, machineName As String) As String

Parameter

source
String

Der Name der Ereignisquelle.

machineName
String

Der Name des Computers, auf dem gesucht werden soll, oder "." für den lokalen Computer.

Gibt zurück

Der Name des Protokolls, das der angegebenen Quelle in der Registrierung zugeordnet ist.

Beispiele

Im folgenden Beispiel wird eine Quelle vom lokalen Computer gelöscht. Das Beispiel bestimmt das Protokoll aus seiner Quelle und löscht dann das Protokoll.

Hinweis

Mehrere Quellen schreiben möglicherweise in ein Ereignisprotokoll. Stellen Sie vor dem Löschen eines benutzerdefinierten Protokolls sicher, dass keine anderen Quellen in dieses Protokoll geschrieben werden.

#using <System.dll>

using namespace System;
using namespace System::Diagnostics;
using namespace System::Threading;
int main()
{
   String^ logName;
   if ( EventLog::SourceExists( "MySource" ) )
   {
      
      // Find the log associated with this source.    
      logName = EventLog::LogNameFromSourceName( "MySource", "." );
      // Make sure the source is in the log we believe it to be in
      if (logName != "MyLog")
          return -1;
      // Delete the source and the log.
      EventLog::DeleteEventSource( "MySource" );
      EventLog::Delete( logName );
      Console::WriteLine( "{0} deleted.", logName );
   }
   else
        {
            // Create the event source to make next try successful.
            EventLog::CreateEventSource("MySource", "MyLog");
        }
}
using System;
using System.Diagnostics;
using System.Threading;

class MySample1
{
    public static void Main()
    {
        string logName;

        if (EventLog.SourceExists("MySource"))
        {
            // Find the log associated with this source.
            logName = EventLog.LogNameFromSourceName("MySource", ".");
            // Make sure the source is in the log we believe it to be in.
            if (logName != "MyLog")
                return;
            // Delete the source and the log.
            EventLog.DeleteEventSource("MySource");
            EventLog.Delete(logName);

            Console.WriteLine(logName + " deleted.");
        }
        else
        {
            // Create the event source to make next try successful.
            EventLog.CreateEventSource("MySource", "MyLog");
        }
    }
}
Option Explicit On
Option Strict On

Imports System.Diagnostics
Imports System.Threading

Class MySample
    Public Shared Sub Main()
        Dim logName As String

        If EventLog.SourceExists("MySource") Then
            ' Find the log associated with this source.    
            logName = EventLog.LogNameFromSourceName("MySource", ".")
            ' Make sure the source is in the log we believe it to be in
            If (logName <> "MyLog") Then
                Return
            End If
            ' Delete the source and the log.
            EventLog.DeleteEventSource("MySource")
            EventLog.Delete(logName)

            Console.WriteLine((logName & " deleted."))
        Else
            ' Create the event source to make next try successful.
            EventLog.CreateEventSource("MySource", "MyLog")
        End If
    End Sub
End Class

Hinweise

Die Ereignisquelle gibt an, was das Ereignis protokolliert. Dies ist häufig der Name der Anwendung oder der Name eines Teilkomponentens der Anwendung, wenn die Anwendung groß ist. Anwendungen und Dienste sollten in das Anwendungsprotokoll oder ein benutzerdefiniertes Protokoll schreiben. Gerätetreiber sollten in das Systemprotokoll schreiben.

Wenn Sie eine neue Quelle erstellen, die jeweils nur in ein Protokoll schreiben kann, registriert das System Ihre Anwendung beim Ereignisprotokoll als gültige Quelle von Einträgen. Die Source -Eigenschaft kann eine beliebige Zeichenfolge sein, aber der Name kann nicht von anderen Quellen auf dem Computer verwendet werden. Ein Versuch, einen duplizierten Source Wert zu erstellen, löst eine Ausnahme aus. Ein einzelnes Ereignisprotokoll kann jedoch viele verschiedene Quellen enthalten, die darauf schreiben.

Gilt für:

Weitere Informationen