Freigeben über


EventLog.Exists Methode

Definition

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)

Quelle:
EventLog.cs
Quelle:
EventLog.cs
Quelle:
EventLog.cs

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

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

Ausnahmen

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 auf dem lokalen Computer ein Protokoll 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 das angegebene logName bereits auf dem lokalen Computer vorhanden ist. Beim logName Parameter wird die Groß-/Kleinschreibung nicht beachtet.

Exists ist eine static Methode, sodass sie für die Klasse selbst aufgerufen werden kann. Es ist nicht erforderlich, eine instance von EventLog zu erstellen, um aufzurufenExists.

Weitere Informationen

Gilt für:

Exists(String, String)

Quelle:
EventLog.cs
Quelle:
EventLog.cs
Quelle:
EventLog.cs

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

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

Ausnahmen

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 zu ermitteln, 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 geben können, verwenden Sie diese Methode, bevor Sie ein neues Protokoll erstellen, um zu ermitteln, ob auf dem durch den machineName Parameter angegebenen Server bereits ein Protokoll mit dem angegebenen logName vorhanden ist. Bei den logName Parametern und machineName wird die Groß-/Kleinschreibung nicht beachtet.

Exists ist eine static Methode, sodass sie für die Klasse selbst aufgerufen werden kann. Es ist nicht erforderlich, eine neue instance von EventLog zu erstellen, um aufzurufenExists.

Weitere Informationen

Gilt für: