EventLog.Clear Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Удаляет все записи из журнала событий.
public:
void Clear();public void Clear();member this.Clear : unit -> unitPublic Sub Clear ()Исключения
Журнал событий не был успешно удален.
–или–
Не удается открыть журнал. Код ошибки Windows недоступен.
Значение не указано для Log свойства. Убедитесь, что имя журнала не является пустой строкой.
Журнал не существует.
Примеры
В следующем примере удаляется журнал событий.
Предостережение
Так как приложения, система, безопасность и другие не настраиваемые журналы могут содержать важные сведения; Перед выполнением этого примера кода обязательно укажите пользовательский журнал. В этом примере удаляется пользовательский журнал myNewLog.
using System;
using System.Diagnostics;
using System.Threading;
class MySample{
public static void Main(){
// Create an EventLog instance and assign its log name.
EventLog myLog = new EventLog();
myLog.Log = "myNewLog";
myLog.Clear();
}
}
Option Explicit
Option Strict
Imports System.Diagnostics
Imports System.Threading
Class MySample
Public Shared Sub Main()
' Create an EventLog instance and assign its log name.
Dim myLog As New EventLog()
myLog.Log = "myNewLog"
myLog.Clear()
End Sub
End Class
Комментарии
Журналы событий задаются с максимальным размером, который определяет количество записей, которые они могут содержать. Если журнал событий заполнен, он останавливает запись новых сведений о событии или начинает перезаписывать предыдущие записи. Если запись событий останавливается, этот метод можно использовать для очистки журнала существующих записей и повторного запуска событий записи. Для очистки записей журнала событий необходимо иметь разрешения администратора на компьютере, на котором находится журнал.
Clear закрывает журнал событий, освобождает дескриптор событий, извлекает новые дескрипторы чтения и записи и повторно открывает журнал событий. События, полученные после вызова метода, не очищаются вместе с существующими событиями.
