TraceListener 类
为监视跟踪和调试输出的侦听器提供 abstract 基类。
**命名空间:**System.Diagnostics
**程序集:**System（在 system.dll 中）
语法
声明
Public MustInherit Class TraceListener
Inherits MarshalByRefObject
Implements IDisposable
用法
Dim instance As TraceListener
public abstract class TraceListener : MarshalByRefObject, IDisposable
public ref class TraceListener abstract : public MarshalByRefObject, IDisposable
public abstract class TraceListener extends MarshalByRefObject implements IDisposable
public abstract class TraceListener extends MarshalByRefObject implements IDisposable
备注
提示
应用于此类的 HostProtectionAttribute 属性 (Attribute) 具有以下 Resources 属性 (Property) 值：Synchronization。HostProtectionAttribute 不影响桌面应用程序（这些应用程序通常通过双击图标、键入命令或在浏览器中输入 URL 来启动）。有关更多信息，请参见 HostProtectionAttribute 类或 SQL Server 编程和宿主保护属性。
有关如何实现 TraceListener 的示例，请参见 DefaultTraceListener、TextWriterTraceListener 和 EventLogTraceListener 类。
必须启用跟踪或调试才能使用跟踪侦听器。下面的语法是编译器特定的语法。如果使用 C# 或 Visual Basic 之外的编译器，请参见相应编译器的文档。
若要在 C# 中启用调试，请在编译代码时将 /d:DEBUG 标志添加到编译器命令行，或者可以将 #define DEBUG 文件添加到文件的顶部。在 Visual Basic 中，将 /d:DEBUG=True 标志添加到编译器命令行。
若要在 C# 中启用跟踪，请在编译代码时将 /d:TRACE 标志添加到编译器命令行中，或者将 #define TRACE 添加到文件的开头。在 Visual Basic 中，将 /d:TRACE=True 标志添加到编译器命令行。
若要添加跟踪侦听器，请编辑与应用程序的名称对应的配置文件。在该文件中，可以添加侦听器、设置其类型和参数、移除侦听器或清除以前由应用程序设置的所有侦听器。应像下面的示例那样对配置文件进行格式化。
<configuration>
<system.diagnostics>
<trace autoflush="false" indentsize="4">
<listeners>
<add name="myListener" type="System.Diagnostics.TextWriterTraceListener" initializeData="TextWriterOutput.log" />
<remove name="Default" />
</listeners>
</trace>
</system.diagnostics>
</configuration>
有关如何使用配置文件进行跟踪的更多信息，请参见 <system.diagnostics> 元素。
给继承者的说明 从此类继承以实现 Debug 和 Trace 类的自定义侦听器。至少必须实现 Write 和 WriteLine 方法。此外，可以实现 Fail、Close 和 Flush 方法。
继承层次结构
System.Object
System.MarshalByRefObject
System.Diagnostics.TraceListener
Microsoft.VisualBasic.Logging.FileLogTraceListener
System.Diagnostics.DefaultTraceListener
System.Diagnostics.EventLogTraceListener
System.Diagnostics.TextWriterTraceListener
System.Web.WebPageTraceListener
线程安全
该类型对于多线程操作是安全的。
平台
Windows 98、Windows 2000 SP4、Windows CE、Windows Millennium Edition、Windows Mobile for Pocket PC、Windows Mobile for Smartphone、Windows Server 2003、Windows XP Media Center Edition、Windows XP Professional x64 Edition、Windows XP SP2、Windows XP Starter Edition
.NET Framework 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表，请参见系统要求。
版本信息
.NET Framework
受以下版本支持：2.0、1.1、1.0
.NET Compact Framework
受以下版本支持：2.0、1.0
请参见
参考
TraceListener 成员
System.Diagnostics 命名空间
DefaultTraceListener 类
ConsoleTraceListener 类
EventLogTraceListener 类
TextWriterTraceListener 类
Debug 类
Trace 类