Ask Learn
Preview
Ask Learn is an AI assistant that can answer questions, clarify concepts, and define terms using trusted Microsoft documentation.
Please sign in to use Ask Learn.
Sign inEventLog.Exists Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Determines whether the specified log exists.
Overloads
| Exists(String) |
Determines whether the log exists on the local computer. |
| Exists(String, String) |
Determines whether the log exists on the specified computer. |
- Source:
- EventLog.cs
- Source:
- EventLog.cs
- Source:
- EventLog.cs
- Source:
- EventLog.cs
- Source:
- EventLog.cs
- Source:
- EventLog.cs
Determines whether the log exists on the local computer.
public:
static bool Exists(System::String ^ logName);C#
public static bool Exists(string logName);static member Exists : string -> boolPublic Shared Function Exists (logName As String) As BooleanParameters
- logName
- String
The name of the log to search for. Possible values include: Application, Security, System, other application-specific logs (such as those associated with Active Directory), or any custom log on the computer.
Returns
true if the log exists on the local computer; otherwise, false.
Exceptions
The logName is null or the value is empty.
Examples
C#
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
Remarks
Use this method to determine if a log exists on the local computer. If you want to determine whether a source exists on the local computer, use SourceExists.
Because this method accesses the registry, you must have the appropriate registry permissions on the local computer; otherwise, the query returns false.
Because you cannot give a new log the name of an existing log on the same computer, use this method before creating a new log to determine if the specified logName already exists on the local computer. The logName parameter is not case sensitive.
Exists is a static method, so it can be called on the class itself. It is not necessary to create an instance of EventLog to call Exists.
See also
Applies to
.NET 10 (package-provided) and other versions
| Product | Versions |
|---|---|
| .NET | 8 (package-provided), 9 (package-provided), 10 (package-provided) |
| .NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1 (package-provided), 4.7.1, 4.7.2 (package-provided), 4.7.2, 4.8 (package-provided), 4.8, 4.8.1 |
| .NET Standard | 2.0 (package-provided) |
| Windows Desktop | 3.0, 3.1, 5, 6, 7, 8, 9, 10 |
- Source:
- EventLog.cs
- Source:
- EventLog.cs
- Source:
- EventLog.cs
- Source:
- EventLog.cs
- Source:
- EventLog.cs
- Source:
- EventLog.cs
Determines whether the log exists on the specified computer.
public:
static bool Exists(System::String ^ logName, System::String ^ machineName);C#
public static bool Exists(string logName, string machineName);static member Exists : string * string -> boolPublic Shared Function Exists (logName As String, machineName As String) As BooleanParameters
- logName
- String
The log for which to search. Possible values include: Application, Security, System, other application-specific logs (such as those associated with Active Directory), or any custom log on the computer.
- machineName
- String
The name of the computer on which to search for the log, or "." for the local computer.
Returns
true if the log exists on the specified computer; otherwise, false.
Exceptions
The machineName parameter is an invalid format. Make sure you have used proper syntax for the computer on which you are searching.
-or-
The logName is null or the value is empty.
Remarks
Use this method to determine if a log exists on a remote computer. If you want to determine whether a source exists on a remote computer, use SourceExists.
Because this method accesses the registry, you must have the appropriate registry permissions on the specified computer; otherwise, the query returns false.
Because you cannot give a new log the name of an existing log on the same computer, use this method before creating a new log to determine if one with the specified logName already exists on the server specified by the machineName parameter. The logName and machineName parameters are not case sensitive.
Exists is a static method, so it can be called on the class itself. It is not necessary to create a new instance of EventLog to call Exists.
See also
Applies to
.NET 10 (package-provided) and other versions
| Product | Versions |
|---|---|
| .NET | 8 (package-provided), 9 (package-provided), 10 (package-provided) |
| .NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1 (package-provided), 4.7.1, 4.7.2 (package-provided), 4.7.2, 4.8 (package-provided), 4.8, 4.8.1 |
| .NET Standard | 2.0 (package-provided) |
| Windows Desktop | 3.0, 3.1, 5, 6, 7, 8, 9, 10 |