EventLog.Exists Метод
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Определяет существование указанного журнала.
| Exists(String) |
Определяет наличие журнала на локальном компьютере. |
| Exists(String, String) |
Определяет наличие журнала на заданном компьютере. |
- Исходный код:
- EventLog.cs
- Исходный код:
- EventLog.cs
- Исходный код:
- EventLog.cs
Определяет наличие журнала на локальном компьютере.
public:
static bool Exists(System::String ^ logName);public static bool Exists (string logName);static member Exists : string -> boolPublic Shared Function Exists (logName As String) As BooleanПараметры
- logName
- String
Имя журнала, который нужно найти. Допустимыми являются значения: Application, Security, System, имена журналов определенных приложений (например, службы каталогов Active Directory) или имя любого пользовательского журнала на компьютере.
Возвращаемое значение
Значение true, если журнал существует на локальном компьютере; в противном случае — false.
Исключения
Параметр 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.
См. также раздел
Применяется к
.NET Framework 4.8.1 и другие версии
| Продукт | Версии |
|---|---|
| .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, 4.7.2, 4.8, 4.8.1 |
| Windows Desktop | 3.0, 3.1, 5, 6, 7, 8, 9 |
- Исходный код:
- EventLog.cs
- Исходный код:
- EventLog.cs
- Исходный код:
- 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 -> boolPublic Shared Function Exists (logName As String, machineName As String) As BooleanПараметры
- logName
- String
Журнал, который нужно найти. Допустимыми являются значения: Application, Security, System, имена журналов определенных приложений (например, службы каталогов Active Directory) или имя любого пользовательского журнала на компьютере.
- machineName
- String
Имя компьютера, на котором выполняется поиск журнала, или значение ".", если используется локальный компьютер.
Возвращаемое значение
Значение true, если журнал существует на заданном компьютере; в противном случае — значение false.
Исключения
Недопустимый формат параметра machineName. Убедитесь, что при поиске на компьютере используется правильный синтаксис.
-или-
Параметр logName принимает значение null или пустое значение.
Комментарии
Используйте этот метод, чтобы определить, существует ли журнал на удаленном компьютере. Если вы хотите определить, существует ли источник на удаленном компьютере, используйте .SourceExists
Так как этот метод обращается к реестру, необходимо иметь соответствующие разрешения реестра на указанном компьютере. В противном случае запрос возвращает false.
Так как нельзя присвоить новому журналу имя существующего журнала на том же компьютере, используйте этот метод перед созданием нового журнала, чтобы определить, существует ли на сервере, logName указанном параметром machineName , уже существует. Параметры logName и machineName не чувствительны к регистру.
Exists является методом static , поэтому его можно вызвать в самом классе. Нет необходимости создавать новый экземпляр для EventLog вызова Exists.
См. также раздел
Применяется к
.NET Framework 4.8.1 и другие версии
| Продукт | Версии |
|---|---|
| .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, 4.7.2, 4.8, 4.8.1 |
| Windows Desktop | 3.0, 3.1, 5, 6, 7, 8, 9 |
