Export (0) Print
Expand All

EventLog.Exists Method (String, String)

Determines whether the log exists on the specified computer.

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

'Declaration
Public Shared Function Exists ( _
	logName As String, _
	machineName As String _
) As Boolean
'Usage
Dim logName As String
Dim machineName As String
Dim returnValue As Boolean

returnValue = EventLog.Exists(logName, machineName)
public static boolean Exists (
	String logName, 
	String machineName
)
public static function Exists (
	logName : String, 
	machineName : String
) : boolean
Not applicable.

Parameters

logName

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

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

Return Value

true if the log exists on the specified computer; otherwise, false.

Exception typeCondition

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 a null reference (Nothing in Visual Basic) 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.

Windows Server 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0

Community Additions

ADD
Show:
© 2014 Microsoft