EventLog.Exists Метод

Определение

Пространство имен:

System.Diagnostics

Сборка:

System.Diagnostics.EventLog.dll

Пакет:

System.Diagnostics.EventLog v8.0.0

Определяет существование указанного журнала.

Перегрузки

Exists(String)	Определяет наличие журнала на локальном компьютере.
Exists(String, String)	Определяет наличие журнала на заданном компьютере.

Exists(String)

Исходный код:

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

Имя журнала, который нужно найти. Допустимыми являются значения: Application, Security, System, имена журналов определенных приложений (например, службы каталогов 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)

Исходный код:

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

Журнал, который нужно найти. Допустимыми являются значения: Application, Security, System, имена журналов определенных приложений (например, службы каталогов Active Directory) или имя любого пользовательского журнала на компьютере.

machineName

String

Имя компьютера, на котором выполняется поиск журнала, или значение ".", если используется локальный компьютер.

Возвращаемое значение

Boolean

Значение true, если журнал существует на заданном компьютере; в противном случае — значение false.

Исключения

ArgumentException

Недопустимый формат параметра machineName. Убедитесь, что при поиске на компьютере используется правильный синтаксис.

-или-

Параметр logName принимает значение null или пустое значение.

Комментарии

Используйте этот метод, чтобы определить, существует ли журнал на удаленном компьютере. Если вы хотите определить, существует ли источник на удаленном компьютере, используйте .SourceExists

Так как этот метод обращается к реестру, необходимо иметь соответствующие разрешения реестра на указанном компьютере. В противном случае запрос возвращает false.

Так как нельзя присвоить новому журналу имя существующего журнала на том же компьютере, используйте этот метод перед созданием нового журнала, чтобы определить, существует ли на сервере, logName указанном параметром machineName , уже существует. Параметры logName и machineName не чувствительны к регистру.

Exists является методом static , поэтому его можно вызвать в самом классе. Нет необходимости создавать новый экземпляр для EventLog вызова Exists.

См. также раздел

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