EventLog.Clear Метод

Определение

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

System.Diagnostics

Сборка:

System.Diagnostics.EventLog.dll

Пакет:

System.Diagnostics.EventLog v8.0.0

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

EventLog.cs

Удаляет все записи из журнала событий.

public:
 void Clear();

public void Clear ();

member this.Clear : unit -> unit

Public Sub Clear ()

Исключения

Win32Exception

Создание журнала событий не было завершено успешно.

-или-

Невозможно открыть журнал. Код ошибки Windows недоступен.

ArgumentException

Для свойства Log не указано значение. Убедитесь, что имя журнала — не пустая строка.

InvalidOperationException

Журнал не существует.

Примеры

В следующем примере очищается журнал событий.

Внимание!

Поскольку журналы application, system, security и другие нестандартные журналы могут содержать важные сведения; перед выполнением этого примера кода обязательно укажите пользовательский журнал. В этом примере удаляется пользовательский журнал myNewLog.

#using <System.dll>

using namespace System;
using namespace System::Diagnostics;
using namespace System::Threading;
int main()
{
   
   // Create an EventLog instance and assign its log name.
   EventLog^ myLog = gcnew EventLog;
   myLog->Log = "myNewLog";
   myLog->Clear();
}

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 закрывает журнал событий, освобождает дескрипторы событий, получает новые дескрипторы чтения и записи и повторно открывает журнал событий. События, полученные после вызова метода , не очищаются вместе с существующими событиями.

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

• Close()
• Delete(String)