DelimitedListTraceListener 类

定义

命名空间:

System.Diagnostics

程序集:

System.Diagnostics.TextWriterTraceListener.dll

程序集:

System.dll

程序集:

netstandard.dll

将跟踪或调试输出定向到文本编写器（如流编写器）或流（如文件流）。

public ref class DelimitedListTraceListener : System::Diagnostics::TextWriterTraceListener

public class DelimitedListTraceListener : System.Diagnostics.TextWriterTraceListener

type DelimitedListTraceListener = class
    inherit TextWriterTraceListener

Public Class DelimitedListTraceListener
Inherits TextWriterTraceListener

继承

Object

MarshalByRefObject

TraceListener

TextWriterTraceListener

DelimitedListTraceListener

继承

Object

TraceListener

TextWriterTraceListener

DelimitedListTraceListener

注解

跟踪输出采用由 Delimiter 属性指定的分隔符分隔的文本格式。 分隔符用于终止输出行中的每个字段。 例如，若要在Microsoft Excel电子表格中显示跟踪输出，可以将逗号 (“，”) 指定为分隔符，并在 CSV) 文件中创建逗号分隔 (值。

重要

此类型实现 IDisposable 接口。 在使用完类型后，您应直接或间接释放类型。 若要直接释放类型，请在块中try/catch调用其Dispose方法。 若要间接释放类型，请使用 using（在 C# 中）或 Using（在 Visual Basic 中）等语言构造。 有关详细信息，请参阅 IDisposable 接口主题中的“使用实现 IDisposable 的对象”一节。

可以在代码中创建一个 DelimitedListTraceListener 。 或者，在仅.NET Framework应用中，可以通过应用程序配置文件启用或禁用它DelimitedListTraceListener，然后在应用程序中使用配置DelimitedListTraceListener。

备注

分隔 DelimitedListTraceListener 符仅使用以单词 Trace开头的方法发出的文本，例如 DelimitedListTraceListener.TraceEvent 或 Trace.TraceWarning。 使用 Debug.Write 和 TextWriterTraceListener.WriteLine 方法发出的跟踪数据不带分隔符。

若要在.NET Framework应用中配置，DelimitedListTraceListener请编辑对应于应用程序名称的配置文件。 在此文件中，可以添加侦听器、设置侦听器的属性或删除侦听器。 配置文件的格式应如以下示例所示：

<configuration>  
  <system.diagnostics>  
    <trace autoflush="false" indentsize="4">  
      <listeners>  
        <add name="delimitedListener"   
          type="System.Diagnostics.DelimitedListTraceListener"   
          delimiter=","   
          initializeData="delimitedOutput.csv"   
          traceOutputOptions="ProcessId, DateTime" />  
      </listeners>  
    </trace>  
  </system.diagnostics>  
</configuration>  

备注

如果尝试写入正在使用或不可用的文件，则文件名会自动以 GUID 作为前缀。

备注

侦听器用于编写跟踪信息的方法DebugTrace和TraceSource类。 侦听器方法（构造函数除外）不应直接从应用程序代码调用。

构造函数

DelimitedListTraceListener(Stream)	初始化写入指定输出流的 DelimitedListTraceListener 类的新实例。
DelimitedListTraceListener(Stream, String)	初始化写入指定输出流并具有指定名称的 DelimitedListTraceListener 类的新实例。
DelimitedListTraceListener(String)	初始化写入指定文件的 DelimitedListTraceListener 类的新实例。
DelimitedListTraceListener(String, String)	初始化写入指定文件并具有指定名称的 DelimitedListTraceListener 类的新实例。
DelimitedListTraceListener(TextWriter)	初始化写入指定文本编写器的 DelimitedListTraceListener 类的新实例。
DelimitedListTraceListener(TextWriter, String)	初始化写入指定文本编写器并具有指定名称的 DelimitedListTraceListener 类的新实例。

属性

Attributes	获取应用程序配置文件中定义的自定义跟踪侦听器特性。 (继承自 TraceListener)
Delimiter	获取或设置分隔列表的分隔符。
Filter	获取或设置跟踪侦听器的跟踪筛选器。 (继承自 TraceListener)
IndentLevel	获取或设置缩进级别。 (继承自 TraceListener)
IndentSize	获取或设置缩进的空格数。 (继承自 TraceListener)
IsThreadSafe	获取一个值，该值指示跟踪侦听器是否是线程安全的。 (继承自 TraceListener)
Name	获取或设置此 TraceListener 的名称。 (继承自 TraceListener)
NeedIndent	获取或设置一个值，该值指示是否缩进输出。 (继承自 TraceListener)
TraceOutputOptions	获取或设置跟踪输出选项。 (继承自 TraceListener)
Writer	获取或设置接收跟踪或调试输出的文本编写器。 (继承自 TextWriterTraceListener)

方法

Close()	关闭 Writer，以使其不再接收跟踪或调试输出。 (继承自 TextWriterTraceListener)
CreateObjRef(Type)	创建一个对象，该对象包含生成用于与远程对象进行通信的代理所需的全部相关信息。 (继承自 MarshalByRefObject)
Dispose()	释放由 TraceListener 使用的所有资源。 (继承自 TraceListener)
Dispose(Boolean)	处置此 TextWriterTraceListener 对象。 (继承自 TextWriterTraceListener)
Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
Fail(String)	实现 TraceListener 类时，向所创建的侦听器发出错误信息。 (继承自 TraceListener)
Fail(String, String)	实现 TraceListener 类时，向所创建的侦听器发出错误信息和详细错误信息。 (继承自 TraceListener)
Flush()	刷新 Writer 的输出缓冲区。 (继承自 TextWriterTraceListener)
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetLifetimeService()	已过时。 检索控制此实例的生存期策略的当前生存期服务对象。 (继承自 MarshalByRefObject)
GetSupportedAttributes()	返回分隔的跟踪侦听器支持的自定义配置文件特性。
GetSupportedAttributes()	获取跟踪侦听器支持的自定义特性。 (继承自 TraceListener)
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)	向特定于侦听器的输出写入跟踪和事件信息。 (继承自 TraceListener)
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)	将跟踪信息、消息和事件信息写入输出文件或流中。
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])	将跟踪信息、格式化对象数组和事件信息写入输出文件或流中。
TraceTransfer(TraceEventCache, String, Int32, String, Guid)	向侦听器特定的输出中写入跟踪信息、消息、相关活动标识和事件信息。 (继承自 TraceListener)
Write(Object)	实现 ToString() 类时，向所创建的侦听器写入对象的 TraceListener 方法值。 (继承自 TraceListener)
Write(Object, String)	实现 ToString() 类时，向所创建的侦听器写入类别名称和对象的 TraceListener 方法值。 (继承自 TraceListener)
Write(String)	将一条消息写入此实例的 Writer。 (继承自 TextWriterTraceListener)
Write(String, String)	实现 TraceListener 类时，向所创建的侦听器写入类别名称和消息。 (继承自 TraceListener)
WriteIndent()	实现此类时，向所创建的侦听器写入缩进，并将 NeedIndent 属性重置为 false。 (继承自 TraceListener)
WriteLine(Object)	实现 TraceListener 类时，向所创建的侦听器写入对象的 ToString() 方法值，后跟行结束符。 (继承自 TraceListener)
WriteLine(Object, String)	实现 TraceListener 类时，向所创建的侦听器写入类别名称和对象的 ToString() 方法值，后跟行结束符。 (继承自 TraceListener)
WriteLine(String)	将一条消息写入该实例的 Writer，后跟行结束符。 默认行结束符是回车符后接一个换行符 (\r\n)。 (继承自 TextWriterTraceListener)
WriteLine(String, String)	实现 TraceListener 类时，向所创建的侦听器写入类别名称和消息，后跟行结束符。 (继承自 TraceListener)