EventLog.Exists Method (String, String)

Determines whether the log exists on the specified computer.

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

public static bool Exists(
	string logName,
	string machineName
)

Parameters

logName
Type: System.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
Type: System.String

The name of the computer on which to search for the log, or "." for the local computer.

Return Value

Type: System.Boolean
true if the log exists on the specified computer; otherwise, false.

ExceptionCondition
ArgumentException

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.

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.

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft