EventLog.Clear 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
从事件日志中删除所有条目。
public:
void Clear();
public void Clear();
member this.Clear : unit -> unit
Public Sub Clear ()
例外
未为 Log 属性指定值。 请确保日志名称不是空字符串。
日志不存在。
示例
以下示例清除事件日志。
Caution
由于应用程序、系统、安全性和其他非自定义日志可能包含重要信息;在执行此示例代码之前,请务必指定自定义日志。 此示例删除自定义日志 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 关闭事件日志,释放事件句柄,检索新的读取和写入句柄,然后重新打开事件日志。 调用方法后收到的事件与现有事件一起未清除。