日志记录示例
更新：2007 年 11 月
此示例演示如何使用和配置 My.Application.Log 对象。
Visual Basic 提供了两种不同的日志记录机制。My.Application.Log 提供对操作系统事件日志的访问，也使您可以将消息写入文本文件。EventLog 组件提供对操作系统事件日志的访问。EventLog 组件使您可以添加和删除日志、添加和移除事件日志源、写入消息和删除消息。有关示例代码，请参见 事件日志示例。
获取示例及其安装说明
执行下列一项或多项操作：
在“帮助”菜单上，单击“示例”。
自述文件将显示有关示例的信息。
访问 Visual Studio 2008 示例网站。该网站提供了最新版本的示例。
在安装了 Visual Studio 的计算机上查找示例。默认情况下，示例和自述文件安装在驱动器号:\Program Files\Microsoft Visual Studio 9.0\Samples\lcid 中。对于 Visual Studio 的速成版，所有示例都可联机找到。
有关更多信息，请参见定位示例文件。
.gif "安全说明") 安全说明： |
|---|
此示例代码用于阐释概念，因此仅显示与此概念相关的代码。该代码可能不符合特定环境的安全要求，因此不应原样搬用所显示的代码。我们建议您添加安全性代码和错误处理代码，以使项目更加安全可靠。Microsoft“按原样”提供此示例代码，不提供任何保证。 |
运行此示例
按 F5。主窗体列出为示例配置的侦听器。
在窗体上的 TextBox 控件中编写一条消息。
单击“写入日志消息”按钮。
消息被写入到各个侦听器。
由 XmlWriterTraceListener 编写的 XML 文件位于 c:\logsamples\SampleLog.xml 中。
由 FileLogTraceListener 编写的纯文本文件位于您的“应用程序数据”目录中。 如果您运行的是 Visual Studio 中的程序，则路径类似于“c:\Documents And Settings\[user]\Application Data\Microsoft Corporation\Microsoft Visual Studio\[8.0*]\LogSample.log”。
演示
此示例包含：
Form1 提供一个简单的窗体，该窗体显示当前为 My.Application.Log 启用的所有侦听器，并具有允许将文本写入 My.Application.Log 的控件。
app.config 定义 My.Application.Log 的配置 - 应将消息写到哪里，应筛选哪些消息等等。
此示例演示如何使用 My.Application.Log 来编写纯文本文件、事件日志和 XML 文件。您可以轻松地实现自定义 TraceListener，以写入其他位置，例如数据库或电子邮件。
每条消息都分配了窗体上选定的“严重度”。当侦听器收到消息时，它可以根据其筛选级别丢弃消息。例如，EventLogTraceListener 组件配置为只写入错误信息，因此您编写的任何具有“信息”或“警告”严重度的消息将被写入到 XML 和纯文本文件，而不是写入 EventLog。
若要更改示例的行为，请编辑项目的 app.config 文件。文件中的注释用作进行更改的指南。
您可以使用 My.Application.Log 和应用程序模型记录启动、关机和未处理的异常。若要查看本示例的代码，请双击“解决方案资源管理器”中“我的项目”。在“应用程序”窗格上单击“查看代码”按钮。