TraceListener 类

定义

命名空间:

System.Diagnostics

程序集:

netstandard.dll, 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

注解

有关如何实现 aTraceListener、查看DefaultTraceListenerTextWriterTraceListener和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(String) 和 WriteLine(String) 方法。 此外，还可以实现和Fail(String)Close()Flush()方法。

构造函数

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

属性

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

方法

名称	说明
Close()	在派生类中重写时，关闭输出流，使其不再接收跟踪或调试输出。
Dispose()	释放该 TraceListener命令使用的所有资源。
Dispose(Boolean)	释放由托管资源使用 TraceListener 的非托管资源，并选择性地释放托管资源。
Equals(Object)	确定指定的对象是否等于当前对象。 (继承自 Object)
Fail(String, String)	向实现 TraceListener 类时创建的侦听器发出错误消息和详细的错误消息。
Fail(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, String, Object[])	将跟踪信息、格式化的对象数组和事件信息写入侦听器特定的输出。
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)	将跟踪信息、消息和事件信息写入侦听器特定的输出。
TraceEvent(TraceEventCache, String, TraceEventType, Int32)	将跟踪和事件信息写入侦听器特定的输出。
TraceTransfer(TraceEventCache, String, Int32, String, Guid)	将跟踪信息、消息、相关活动标识和事件信息写入侦听器特定的输出。
Write(Object, String)	将类别名称和对象 ToString() 方法的值写入实现 TraceListener 类时创建的侦听器。
Write(Object)	将对象 ToString() 方法的值写入实现 TraceListener 类时创建的侦听器。
Write(String, String)	将类别名称和消息写入实现 TraceListener 类时创建的侦听器。
Write(String)	在派生类中重写时，将指定的消息写入在派生类中创建的侦听器。
WriteIndent()	将缩进写入实现此类时创建的侦听器，并将属性重置 NeedIndent 为 false。
WriteLine(Object, String)	将类别名称和对象 ToString() 方法的值写入实现 TraceListener 类时创建的侦听器，后跟行终止符。
WriteLine(Object)	将对象 ToString() 方法的值写入实现 TraceListener 类时创建的侦听器，后跟行终止符。
WriteLine(String, String)	将类别名称和消息写入实现 TraceListener 类时创建的侦听器，后跟行终止符。
WriteLine(String)	在派生类中重写时，将消息写入在派生类中创建的侦听器，后跟行终止符。

线程安全性

此类型是线程安全的。

另请参阅

• DefaultTraceListener
• ConsoleTraceListener
• EventLogTraceListener
• TextWriterTraceListener
• Debug
• Trace
• <system.diagnostics> 元素