C#中EventLog组件应用实例

EventLog组件

1． 功能

使用EventLog组件可以轻松地连接到本地和远程计算机上的事件日志，并向这些日志中写入项；也可以从现有日志中读取条目并创建自己的自定义事件日志；还可以使用“服务器资源管理器”查看有访问权限的任何服务器的事件日志列表。用户可以展开“服务器资源管理器”中的“事件日志”节点以查看当前存在的日志列表，以及已写入其中的事件。此外，还可以从“服务器资源管理器”中将某些特定事件日志拖放到设计器上，以创建EventLog组件的实例，该实例自动将其属性设置为指向选定的日志。图1所示为EventLog组件。



图1 EventLog组件

2．属性

EventLog组件的常用属性及说明如表1所示。



表1 EventLog组件常用属性及说明

下面对比较重要的属性进行详细介绍。

（1）Entries属性。该属性获取事件日志的内容。

语法：

public EventLogEntryCollection Entries { get; }
属性值：EventLogEntryCollection保留事件日志中的项。每个项均与EventLogEntry类的一个实例关联。

（2）Log属性。该属性获取或设置读取或写入的日志名称。

语法：

public string Log { get; set; }
属性值：日志的名称可以是Application、System和Security，或是一个自定义的日志名称。默认值为空字符串（""）。

（3）Source属性。

语法：

public string Source { get; set; }
属性值：在事件日志中，注册为项源的名称。默认值为空字符串（""）。

示例

Entries属性、Log属性和Source属性的使用

单击图2中的【创建日志】按钮会触发该按钮的Click事件，在该事件下，调用CreateEventSource方法创建一个自定义日志。



图2 日志操作

程序主要代码如下：

private void button1_Click(object sender, EventArgs e)

{

if (System.Diagnostics.EventLog.SourceExists("Source1"))

{

System.Diagnostics.EventLog.DeleteEventSource("Source1");

}

// Logs and Sources are created as a pair.

System.Diagnostics.EventLog.CreateEventSource("Source1", "NewLog1");

// Associate the EventLog component with the new log.

eventLog1.Log = "NewLog1";

eventLog1.Source = "Source1";

this.eventLog1.MachineName = ".";

MessageBox.Show("日志创建成功");

}
当单击【写入日志】按钮时，将会触发该按钮的Click事件，在该事件下，调用WriteEntry方法，向自定义日志中写入内容。