EventLog.Exists Methode

Definition

Namespace:

System.Diagnostics

Assembly:

System.Diagnostics.EventLog.dll

Assembly:

System.dll

Bestimmt, ob das angegebene Protokoll vorhanden ist.

Überlädt

Exists(String)	Bestimmt, ob das Protokoll auf dem lokalen Computer vorhanden ist.
Exists(String, String)	Bestimmt, ob das Protokoll auf dem angegebenen Computer vorhanden ist.

Exists(String)

Bestimmt, ob das Protokoll auf dem lokalen Computer vorhanden ist.

public:
 static bool Exists(System::String ^ logName);

public static bool Exists (string logName);

static member Exists : string -> bool

Public Shared Function Exists (logName As String) As Boolean

Parameter

logName

String

Der Name des zu suchenden Protokolls. Folgende Werte sind möglich: Anwendungs-, Sicherheits-, System- oder andere anwendungsspezifische Protokolle, z. B. im Zusammenhang mit Active Directory, oder ein beliebiges benutzerdefiniertes Protokoll auf dem Computer.

Gibt zurück

Boolean

true, wenn das Protokoll auf dem lokalen Computer vorhanden ist, andernfalls false.

Ausnahmen

ArgumentException

logName ist null oder eine leere Zeichenfolge.

Beispiele

      String^ myLog = "myNewLog";
      if ( EventLog::Exists( myLog ) )
      {
         Console::WriteLine( "Log '{0}' exists.", myLog );
      }
      else
      {
         Console::WriteLine( "Log '{0}' does not exist.", myLog );
      }
   }
   catch ( Exception^ e ) 
   {
      Console::WriteLine( "Exception: {0}", e->Message );
   }

}

string myLog = "myNewLog";
if (EventLog.Exists(myLog))
{
   Console.WriteLine("Log '"+myLog+"' exists.");
}
else
{
   Console.WriteLine("Log '"+myLog+"' does not exist.");
}

Dim myLog As String = "myNewLog"
If EventLog.Exists(myLog) Then
   Console.WriteLine("Log '" + myLog + "' exists.")
Else
   Console.WriteLine("Log '" + myLog + "' does not exist.")
End If

Hinweise

Verwenden Sie diese Methode, um zu ermitteln, ob ein Protokoll auf dem lokalen Computer vorhanden ist. Wenn Sie ermitteln möchten, ob eine Quelle auf dem lokalen Computer vorhanden ist, verwenden Sie SourceExists.

Da diese Methode auf die Registrierung zugreift, müssen Sie über die entsprechenden Registrierungsberechtigungen auf dem lokalen Computer verfügen; andernfalls gibt die Abfrage zurück false.

Da Sie einem neuen Protokoll nicht den Namen eines vorhandenen Protokolls auf demselben Computer geben können, verwenden Sie diese Methode, bevor Sie ein neues Protokoll erstellen, um zu ermitteln, ob die angegebene logName bereits auf dem lokalen Computer vorhanden ist. Der logName Parameter ist nicht groß- und kleinschreibungsempfindlich.

Exists ist eine static Methode, sodass sie für die Klasse selbst aufgerufen werden kann. Es ist nicht erforderlich, eine Instanz EventLog des Aufrufens Existszu erstellen.

Siehe auch

• CreateEventSource
• Delete(String)
• SourceExists(String)
• Log

Exists(String, String)

Bestimmt, ob das Protokoll auf dem angegebenen Computer vorhanden ist.

public:
 static bool Exists(System::String ^ logName, System::String ^ machineName);

public static bool Exists (string logName, string machineName);

[System.MonoNotSupported("remote machine is not supported")]
public static bool Exists (string logName, string machineName);

static member Exists : string * string -> bool

[<System.MonoNotSupported("remote machine is not supported")>]
static member Exists : string * string -> bool

Public Shared Function Exists (logName As String, machineName As String) As Boolean

Parameter

logName

String

Das zu suchende Protokoll. Folgende Werte sind möglich: Anwendungs-, Sicherheits-, System- oder andere anwendungsspezifische Protokolle, z. B. im Zusammenhang mit Active Directory, oder ein beliebiges benutzerdefiniertes Protokoll auf dem Computer.

machineName

String

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

Gibt zurück

Boolean

true, wenn das Protokoll auf dem angegebenen Computer vorhanden ist, andernfalls false.

Attribute

MonoNotSupportedAttribute

Ausnahmen

ArgumentException

Der machineName-Parameter hat ein ungültiges Format. Stellen Sie sicher, dass Sie für den Computer, auf dem Sie die Suche durchführen, die richtige Syntax verwenden.

- oder - logName ist null oder eine leere Zeichenfolge.

Hinweise

Verwenden Sie diese Methode, um festzustellen, ob ein Protokoll auf einem Remotecomputer vorhanden ist. Wenn Sie ermitteln möchten, ob eine Quelle auf einem Remotecomputer vorhanden ist, verwenden Sie SourceExists.

Da diese Methode auf die Registrierung zugreift, müssen Sie über die entsprechenden Registrierungsberechtigungen auf dem angegebenen Computer verfügen; andernfalls gibt die Abfrage zurück false.

Da Sie einem neuen Protokoll nicht den Namen eines vorhandenen Protokolls auf demselben Computer zuweisen können, verwenden Sie diese Methode, bevor Sie ein neues Protokoll erstellen, um zu bestimmen, ob eine mit dem angegebenen logName bereits auf dem vom Parameter angegebenen machineName Server vorhanden ist. Bei den logName Parametern wird keine Groß-/ machineName Kleinschreibung beachtet.

Exists ist eine static Methode, sodass sie für die Klasse selbst aufgerufen werden kann. Es ist nicht erforderlich, eine neue Instanz für EventLog den Aufruf Existszu erstellen.

Siehe auch

• CreateEventSource
• Delete(String)
• SourceExists(String)
• Log
• MachineName