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

檔案不存在。

範例

下列範例會清除事件記錄檔。

警告

因為應用程式、系統、安全性和其他非自定義記錄可以包含重要資訊;在執行此範例程式代碼之前，請務必指定自定義記錄檔。 這個範例會刪除自訂記錄 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)