語言

EventLog.Clear 方法

定義

移除事件日誌中的所有條目。

public:
 void Clear();
public void Clear();
member this.Clear : unit -> unit
Public 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 關閉事件日誌,釋放事件句柄,取得新的讀寫句柄,並重新開啟事件日誌。 呼叫方法後收到的事件並未與現有事件一同清除。

適用於

另請參閱