EventLog.LogNameFromSourceName-Methode

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

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

Syntax

'Declaration
Public Shared Function LogNameFromSourceName ( _
    source As String, _
    machineName As String _
) As String
'Usage
Dim source As String
Dim machineName As String
Dim returnValue As String

returnValue = EventLog.LogNameFromSourceName(source, machineName)

public static string LogNameFromSourceName (
    string source,
    string machineName
)

public:
static String^ LogNameFromSourceName (
    String^ source, 
    String^ machineName
)

public static String LogNameFromSourceName (
    String source, 
    String machineName
)

public static function LogNameFromSourceName (
    source : String, 
    machineName : String
) : String

Parameter

• source
  Der Name der Ereignisquelle.

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

Rückgabewert

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

Hinweise

Die Ereignisquelle gibt an, wodurch das Ereignis protokolliert wird. Häufig ist dies der Name der Anwendung oder bei großen Anwendungen der Name einer Unterkomponente. Anwendungen und Dienste schreiben in das Anwendungsprotokoll oder ein benutzerdefiniertes Protokoll. Gerätetreiber schreiben i. d. R. in das Systemprotokoll.

Wenn Sie eine neue Quelle erstellen, die immer nur in ein Protokoll schreiben kann, registriert das System die Anwendung im Ereignisprotokoll als gültige Quelle für Einträge. Die Source-Eigenschaft kann eine beliebige Zeichenfolge sein, der Name darf jedoch nicht von anderen Quellen auf dem Computer verwendet werden. Beim Versuch, einen doppelten Source-Wert zu erstellen, wird eine Ausnahme ausgelöst. Es können jedoch mehrere Quellen in ein Ereignisprotokoll schreiben.

Beispiel

Im folgenden Beispiel wird eine Quelle auf dem lokalen Computer gelöscht. Im Beispiel wird das Protokoll anhand der Quelle bestimmt und anschließend das Protokoll gelöscht.

Hinweis

Es können mehrere Quellen in ein Ereignisprotokoll schreiben. Stellen Sie vor dem Löschen eines benutzerdefinierten Protokolls sicher, dass keine anderen Quellen in dieses Protokoll schreiben.

Option Explicit
Option Strict

Imports System
Imports System.Diagnostics
Imports System.Threading

Class MySample
    Public Shared Sub Main()
        Dim logName As String
        
        If EventLog.SourceExists("MyOldSource") Then
            ' Find the log associated with this source.    
            logName = EventLog.LogNameFromSourceName("MyOldSource", ".")
            
            ' Delete the source and the log.
            EventLog.DeleteEventSource("MyOldSource")
            EventLog.Delete(logName)
            
            Console.WriteLine((logName & " deleted."))
        End If
    End Sub 'Main
End Class 'MySample

using System;
using System.Diagnostics;
using System.Threading;
              
class MySample{

    public static void Main(){

         string logName;
       
        if(EventLog.SourceExists("MyOldSource")){
        // Find the log associated with this source.    
            logName = EventLog.LogNameFromSourceName("MyOldSource", ".");

        // Delete the source and the log.
            EventLog.DeleteEventSource("MyOldSource");
            EventLog.Delete(logName);
            
            Console.WriteLine(logName + " deleted.");    
        }                                                                        
    } 
}
   

#using <System.dll>

using namespace System;
using namespace System::Diagnostics;
using namespace System::Threading;
int main()
{
   String^ logName;
   if ( EventLog::SourceExists( "MyOldSource" ) )
   {
      
      // Find the log associated with this source.    
      logName = EventLog::LogNameFromSourceName( "MyOldSource", "." );
      
      // Delete the source and the log.
      EventLog::DeleteEventSource( "MyOldSource" );
      EventLog::Delete( logName );
      Console::WriteLine( "{0} deleted.", logName );
   }
}

import System.*;
import System.Diagnostics.*;
import System.Threading.*;

class MySample
{
    public static void main(String[] args)
    {
        String logName;
        if (EventLog.SourceExists("MyOldSource")) {
            // Find the log associated with this source.    
            logName = EventLog.LogNameFromSourceName("MyOldSource", ".");

            // Delete the source and the log.
            EventLog.DeleteEventSource("MyOldSource");
            EventLog.Delete(logName);
            Console.WriteLine(logName + " deleted.");
        }
    } //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
Source
MachineName
Log
SourceExists