EventLog.Exists Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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.