TextWriterTraceListener 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
将跟踪或调试输出定向到 TextWriter 或 Stream，如 FileStream。
public ref class TextWriterTraceListener : System::Diagnostics::TraceListenerpublic class TextWriterTraceListener : System.Diagnostics.TraceListenertype TextWriterTraceListener = class
inherit TraceListenerPublic Class TextWriterTraceListener
Inherits TraceListener- 继承
- 继承
- 派生
示例
以下示例实现 类的实例， TextWriterTraceListener 该类使用 StreamWriter 调用 myOutputWriter 的 写入名为 的文件 TestFile.txt。 首先，此示例创建一个用于输出的文件。 然后，它为第一个文本编写器创建 StreamWriter ，为其分配输出文件，并将其添加到 。Listeners 然后，代码将一行文本输出到文件中。 最后，该示例刷新输出缓冲区。
运行此示例后，可以打开 TestFile.txt 文件以查看输出。
void main()
{
#if defined(TRACE)
// Create a file for output named TestFile.txt.
Stream^ myFile = File::Create( "TestFile.txt" );
// Create a new text writer using the output stream and
// add it to the trace listeners.
TextWriterTraceListener^ myTextListener =
gcnew TextWriterTraceListener( myFile );
Trace::Listeners->Add( myTextListener );
// Write output to the file.
Trace::Write( "Test output " );
// Flush the output.
Trace::Flush();
Trace::Close();
#endif
}
public class Sample
{
public static int Main(string[] args) {
// Create a file for output named TestFile.txt.
Stream myFile = File.Create("TestFile.txt");
/* Create a new text writer using the output stream, and add it to
* the trace listeners. */
TextWriterTraceListener myTextListener = new
TextWriterTraceListener(myFile);
Trace.Listeners.Add(myTextListener);
// Write output to the file.
Trace.Write("Test output ");
// Flush the output.
Trace.Flush();
return 0;
}
}
Public Class Sample
Public Shared Sub Main()
' Create a file for output named TestFile.txt.
Dim myFile As Stream = File.Create("TestFile.txt")
' Create a new text writer using the output stream, and add it to
' the trace listeners.
Dim myTextListener As New TextWriterTraceListener(myFile)
Trace.Listeners.Add(myTextListener)
' Write output to the file.
Trace.Write("Test output ")
' Flush the output.
Trace.Flush()
System.Environment.ExitCode = 0
End Sub
End Class
注解
类 TextWriterTraceListener 提供 Writer 属性来获取或设置接收跟踪或调试输出的文本编写器。
重要
此类型实现 IDisposable 接口。 在使用完类型后，您应直接或间接释放类型。 若要直接释放类型，请在 try/catch 块中调用其 Dispose 方法。 若要间接释放类型，请使用 using（在 C# 中）或 Using（在 Visual Basic 中）等语言构造。 有关详细信息，请参阅 IDisposable 接口主题中的“使用实现 IDisposable 的对象”一节。
此类还向 CloseWriter 提供方法，以便它不再接收跟踪或调试输出、到 Flush 的 Writer输出缓冲区以及 Write 向 Writer的消息。
必须启用跟踪或调试才能使用跟踪侦听器。 以下语法特定于编译器。 如果使用 C# 或 Visual Basic 以外的编译器，请参阅编译器的文档。
若要在 C# 中启用调试，请在编译代码时将 标志添加到
/d:DEBUG编译器命令行，也可以将 添加到#define DEBUG文件的顶部。 在 Visual Basic 中，将/d:DEBUG=True标志添加到编译器命令行。若要在 C# 中启用跟踪，请在编译代码时将 标志添加到
/d:TRACE编译器命令行，或将 添加到#define TRACE文件的顶部。 在 Visual Basic 中，将/d:TRACE=True标志添加到编译器命令行。
若要在.NET Framework应用中添加跟踪侦听器，请编辑与应用程序名称对应的配置文件。 在此文件中，可以添加侦听器、设置其类型并设置其参数、删除侦听器或清除以前由应用程序设置的所有侦听器。 配置文件的格式应如以下示例所示。
<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>
注意
如果尝试写入正在使用或不可用的文件，则文件名会自动以 GUID 作为前缀。
构造函数
| TextWriterTraceListener() |
用 TextWriter 作为输出接收者来初始化 TextWriterTraceListener 类的新实例。 |
| TextWriterTraceListener(Stream) |
用流作为调试和跟踪输出的接收者来初始化 TextWriterTraceListener 类的新实例。 |
| TextWriterTraceListener(Stream, String) |
用流作为调试和跟踪输出的接收者来初始化具有指定名称的 TextWriterTraceListener 类的新实例。 |
| TextWriterTraceListener(String) |
用文件作为调试和跟踪输出的接收者来初始化 TextWriterTraceListener 类的新实例。 |
| TextWriterTraceListener(String, String) |
用文件作为调试和跟踪输出的接收者来初始化具有指定名称的 TextWriterTraceListener 类的新实例。 |
| TextWriterTraceListener(TextWriter) |
用指定的编写器作为跟踪或调试输出的接收者来初始化 TextWriterTraceListener 类的新实例。 |
| TextWriterTraceListener(TextWriter, String) |
用指定的编写器作为跟踪或调试输出的接收者来初始化具有指定名称的 TextWriterTraceListener 类的新实例。 |
属性
| Attributes |
获取应用程序配置文件中定义的自定义跟踪侦听器特性。 (继承自 TraceListener) |
| Filter |
获取或设置跟踪侦听器的跟踪筛选器。 (继承自 TraceListener) |
| IndentLevel |
获取或设置缩进级别。 (继承自 TraceListener) |
| IndentSize |
获取或设置缩进的空格数。 (继承自 TraceListener) |
| IsThreadSafe |
获取一个值，该值指示跟踪侦听器是否是线程安全的。 (继承自 TraceListener) |
| Name |
获取或设置此 TraceListener 的名称。 (继承自 TraceListener) |
| NeedIndent |
获取或设置一个值，该值指示是否缩进输出。 (继承自 TraceListener) |
| TraceOutputOptions |
获取或设置跟踪输出选项。 (继承自 TraceListener) |
| Writer |
获取或设置接收跟踪或调试输出的文本编写器。 |
