EventLog.Exists 方法

定义

命名空间:

System.Diagnostics

程序集:

System.Diagnostics.EventLog.dll

包:

System.Diagnostics.EventLog v8.0.0

确定指定的日志是否存在。

重载

Exists(String)	确定该日志是否存在于本地计算机上。
Exists(String, String)	确定该日志是否存在于指定计算机上。

Exists(String)

Source:

EventLog.cs

确定该日志是否存在于本地计算机上。

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

参数

logName

String

要搜索的日志的名称。 可能的值包括：“应用程序”、“安全性”、“系统”、其他应用程序特定的日志（如与 Active Directory 关联的日志）或计算机上的任何自定义日志。

返回

Boolean

如果该日志存在于本地计算机上，则为 true；否则为 false。

例外

ArgumentException

logName 为 null 或该值为空。

示例

      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

注解

使用此方法可确定本地计算机上是否存在日志。 如果要确定本地计算机上是否存在源，请使用 SourceExists。

由于此方法访问注册表，因此必须具有本地计算机上的相应注册表权限;否则，查询将 false返回 。

由于无法为新日志指定同一计算机上现有日志的名称，因此请在创建新日志之前使用此方法来确定本地计算机上是否已存在指定的 logName 。 参数 logName 不区分大小写。

Exists 是一个 static 方法，因此可以对类本身调用它。 无需创建 实例 EventLog 来调用 Exists。

另请参阅

• CreateEventSource
• Delete(String)
• SourceExists(String)
• Log

Exists(String, String)

Source:

EventLog.cs

确定该日志是否存在于指定计算机上。

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

参数

logName

String

要搜索的日志。 可能的值包括：“应用程序”、“安全性”、“系统”、其他应用程序特定的日志（如与 Active Directory 关联的日志）或计算机上的任何自定义日志。

machineName

String

要在其上搜索日志的计算机的名称，对于本地计算机则为“.”。

返回

Boolean

如果该日志存在于指定的计算机上，则为 true；否则为 false。

例外

ArgumentException

machineName 参数的格式无效。 请确保对在其上执行搜索的计算机使用了正确的语法。

- 或 -

logName 为 null 或该值为空。

注解

使用此方法可确定远程计算机上是否存在日志。 如果要确定远程计算机上是否存在源，请使用 SourceExists。

由于此方法访问注册表，因此您必须在指定的计算机上具有相应的注册表权限;否则，查询将 false返回 。

由于无法为新日志提供同一计算机上现有日志的名称，因此请在创建新日志之前使用此方法来确定参数指定的machineName服务器上是否已存在具有指定 logName 的日志。 logName和 machineName 参数不区分大小写。

Exists 是一个 static 方法，因此可以对类本身调用它。 无需创建 的新实例 EventLog 来调用 Exists。

另请参阅

• CreateEventSource
• Delete(String)
• SourceExists(String)
• Log
• MachineName