TraceListener 类

定义

命名空间:

System.Diagnostics

程序集:

System.Diagnostics.TraceSource.dll

Source:

TraceListener.cs

为监视跟踪和调试输出的侦听器提供 abstract 基类。

public ref class TraceListener abstract : MarshalByRefObject, IDisposable

public abstract class TraceListener : MarshalByRefObject, IDisposable

type TraceListener = class
    inherit MarshalByRefObject
    interface IDisposable

Public MustInherit Class TraceListener
Inherits MarshalByRefObject
Implements IDisposable

继承

Object

MarshalByRefObject

TraceListener

派生

Microsoft.VisualBasic.Logging.FileLogTraceListener

System.Diagnostics.DefaultTraceListener

System.Diagnostics.Eventing.EventProviderTraceListener

System.Diagnostics.EventLogTraceListener

System.Diagnostics.TextWriterTraceListener

System.Web.IisTraceListener

System.Web.WebPageTraceListener

实现

IDisposable

注解

有关如何实现 TraceListener的示例， DefaultTraceListener请参阅 和 TextWriterTraceListenerEventLogTraceListener 类。

必须启用跟踪或调试才能使用跟踪侦听器。 以下语法特定于编译器。 如果使用 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.诊断>。

实施者说明

从此类继承，以实现 和 Trace 类的Debug自定义侦听器。 至少必须实现 Write(String) 和 WriteLine(String) 方法。 此外，还可以实现 Fail(String)、 Close() 和 Flush() 方法。

构造函数

TraceListener()	初始化 TraceListener 类的新实例。
TraceListener(String)	用指定的名称作为侦听器来初始化 TraceListener 类的新实例。

属性

Attributes	获取应用程序配置文件中定义的自定义跟踪侦听器特性。
Filter	获取或设置跟踪侦听器的跟踪筛选器。
IndentLevel	获取或设置缩进级别。
IndentSize	获取或设置缩进的空格数。
IsThreadSafe	获取一个值，该值指示跟踪侦听器是否是线程安全的。
Name	获取或设置此 TraceListener 的名称。
NeedIndent	获取或设置一个值，该值指示是否缩进输出。
TraceOutputOptions	获取或设置跟踪输出选项。

方法

Close()	在派生类中被重写时，关闭输出流以使它不再接收跟踪或调试输出。
CreateObjRef(Type)	创建一个对象，该对象包含生成用于与远程对象进行通信的代理所需的全部相关信息。 (继承自 MarshalByRefObject)
Dispose()	释放由 TraceListener 使用的所有资源。
Dispose(Boolean)	释放由 TraceListener 占用的非托管资源，还可以另外再释放托管资源。
Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
Fail(String)	实现 TraceListener 类时，向所创建的侦听器发出错误信息。
Fail(String, String)	实现 TraceListener 类时，向所创建的侦听器发出错误信息和详细错误信息。
Flush()	在派生类中被重写时，刷新输出缓冲区。
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetLifetimeService()	已过时. 检索控制此实例的生存期策略的当前生存期服务对象。 (继承自 MarshalByRefObject)
GetSupportedAttributes()	获取跟踪侦听器支持的自定义特性。
GetType()	获取当前实例的 Type。 (继承自 Object)
InitializeLifetimeService()	已过时. 获取生存期服务对象来控制此实例的生存期策略。 (继承自 MarshalByRefObject)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
MemberwiseClone(Boolean)	创建当前 MarshalByRefObject 对象的浅表副本。 (继承自 MarshalByRefObject)
ToString()	返回表示当前对象的字符串。 (继承自 Object)
TraceData(TraceEventCache, String, TraceEventType, Int32, Object)	向特定于侦听器的输出中写入跟踪信息、数据对象和事件信息。
TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])	向特定于侦听器的输出中写入跟踪信息、数据对象的数组和事件信息。
TraceEvent(TraceEventCache, String, TraceEventType, Int32)	向特定于侦听器的输出写入跟踪和事件信息。
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)	向特定于侦听器的输出中写入跟踪信息、消息和事件信息。
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])	向特定于侦听器的输出中写入跟踪信息、格式化对象数组和事件信息。
TraceTransfer(TraceEventCache, String, Int32, String, Guid)	向侦听器特定的输出中写入跟踪信息、消息、相关活动标识和事件信息。
Write(Object)	实现 ToString() 类时，向所创建的侦听器写入对象的 TraceListener 方法值。
Write(Object, String)	实现 ToString() 类时，向所创建的侦听器写入类别名称和对象的 TraceListener 方法值。
Write(String)	在派生类中被重写时，向在该派生类中所创建的侦听器写入指定消息。
Write(String, String)	实现 TraceListener 类时，向所创建的侦听器写入类别名称和消息。
WriteIndent()	实现此类时，向所创建的侦听器写入缩进，并将 NeedIndent 属性重置为 false。
WriteLine(Object)	实现 TraceListener 类时，向所创建的侦听器写入对象的 ToString() 方法值，后跟行结束符。
WriteLine(Object, String)	实现 TraceListener 类时，向所创建的侦听器写入类别名称和对象的 ToString() 方法值，后跟行结束符。
WriteLine(String)	在派生类中被重写时，向在该派生类中所创建的侦听器写入消息，后跟行结束符。
WriteLine(String, String)	实现 TraceListener 类时，向所创建的侦听器写入类别名称和消息，后跟行结束符。

线程安全性

此类型是线程安全的。

另请参阅

• DefaultTraceListener
• ConsoleTraceListener
• EventLogTraceListener
• TextWriterTraceListener
• Debug
• Trace
• <系统。诊断> 元素