DefaultTraceListener 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
提供用于跟踪的默认输出方法和行为。
public ref class DefaultTraceListener : System::Diagnostics::TraceListenerpublic class DefaultTraceListener : System.Diagnostics.TraceListener[System.Runtime.InteropServices.ComVisible(false)]
public class DefaultTraceListener : System.Diagnostics.TraceListenertype DefaultTraceListener = class
inherit TraceListener[<System.Runtime.InteropServices.ComVisible(false)>]
type DefaultTraceListener = class
inherit TraceListenerPublic Class DefaultTraceListener
Inherits TraceListener- 继承
- 继承
- 属性
示例
下面的代码示例计算二项式系数，它们是概率和统计信息中使用的值。 此示例使用 来 DefaultTraceListener 跟踪结果和记录错误。 它创建一个新的 DefaultTraceListener，将其添加到集合， Trace.Listeners 并将 属性设置为 LogFileName 命令行参数中指定的日志文件。
如果在处理输入参数时检测到错误，或者如果 CalcBinomial 函数引发异常，方法会 Fail 记录并显示错误消息。 AssertUiEnabled如果 属性为 false，则还会将错误消息写入控制台。 成功计算结果后， Write(String) 和 WriteLine(String) 方法会将结果写入日志文件。
、 FailWrite和 WriteLine 方法导致跟踪信息仅写入 到 。DefaultTraceListener 若要将跟踪信息写入集合中的所有Trace.Listeners侦听器，请使用 Fail类的 Trace 、 Write和 WriteLine 方法。
using System;
using System.Diagnostics;
using Microsoft.VisualBasic;
class Binomial
{
// args(0) is the number of possibilities for binomial coefficients.
// args(1) is the file specification for the trace log file.
public static void Main(string[] args)
{
decimal possibilities;
decimal iter;
// Remove the original default trace listener.
Trace.Listeners.RemoveAt(0);
// Create and add a new default trace listener.
DefaultTraceListener defaultListener;
defaultListener = new DefaultTraceListener();
Trace.Listeners.Add(defaultListener);
// Assign the log file specification from the command line, if entered.
if (args.Length>=2)
{
defaultListener.LogFileName = args[1];
}
// Validate the number of possibilities argument.
if (args.Length>=1)
// Verify that the argument is a number within the correct range.
{
try
{
const decimal MAX_POSSIBILITIES = 99;
possibilities = Decimal.Parse(args[0]);
if (possibilities<0||possibilities>MAX_POSSIBILITIES)
{
throw new Exception(String.Format("The number of possibilities must " +
"be in the range 0..{0}.", MAX_POSSIBILITIES));
}
}
catch(Exception ex)
{
string failMessage = String.Format("\"{0}\" " +
"is not a valid number of possibilities.", args[0]);
defaultListener.Fail(failMessage, ex.Message);
if (!defaultListener.AssertUiEnabled)
{
Console.WriteLine(failMessage+ "\n" +ex.Message);
}
return;
}
}
else
{
// Report that the required argument is not present.
const string ENTER_PARAM = "Enter the number of " +
"possibilities as a command line argument.";
defaultListener.Fail(ENTER_PARAM);
if (!defaultListener.AssertUiEnabled)
{
Console.WriteLine(ENTER_PARAM);
}
return;
}
for(iter=0; iter<=possibilities; iter++)
{
decimal result;
string binomial;
// Compute the next binomial coefficient and handle all exceptions.
try
{
result = CalcBinomial(possibilities, iter);
}
catch(Exception ex)
{
string failMessage = String.Format("An exception was raised when " +
"calculating Binomial( {0}, {1} ).", possibilities, iter);
defaultListener.Fail(failMessage, ex.Message);
if (!defaultListener.AssertUiEnabled)
{
Console.WriteLine(failMessage+ "\n" +ex.Message);
}
return;
}
// Format the trace and console output.
binomial = String.Format("Binomial( {0}, {1} ) = ", possibilities, iter);
defaultListener.Write(binomial);
defaultListener.WriteLine(result.ToString());
Console.WriteLine("{0} {1}", binomial, result);
}
}
public static decimal CalcBinomial(decimal possibilities, decimal outcomes)
{
// Calculate a binomial coefficient, and minimize the chance of overflow.
decimal result = 1;
decimal iter;
for(iter=1; iter<=possibilities-outcomes; iter++)
{
result *= outcomes+iter;
result /= iter;
}
return result;
}
}
Imports System.Diagnostics
Module Binomial
' args(0) is the number of possibilities for binomial coefficients.
' args(1) is the file specification for the trace log file.
Sub Main(ByVal args() As String)
Dim possibilities As Decimal
Dim iter As Decimal
' Remove the original default trace listener.
Trace.Listeners.RemoveAt(0)
' Create and add a new default trace listener.
Dim defaultListener As DefaultTraceListener
defaultListener = New DefaultTraceListener
Trace.Listeners.Add(defaultListener)
' Assign the log file specification from the command line, if entered.
If args.Length >= 2 Then
defaultListener.LogFileName = args(1)
End If
' Validate the number of possibilities argument.
If args.Length >= 1 Then
' Verify that the argument is a number within the correct range.
Try
Const MAX_POSSIBILITIES As Decimal = 99
possibilities = Decimal.Parse(args(0))
If possibilities < 0 Or possibilities > MAX_POSSIBILITIES Then
Throw New Exception( _
String.Format("The number of possibilities must " & _
"be in the range 0..{0}.", MAX_POSSIBILITIES))
End If
Catch ex As Exception
Dim failMessage As String = String.Format("""{0}"" " & _
"is not a valid number of possibilities.", args(0))
defaultListener.Fail(failMessage, ex.Message)
If Not defaultListener.AssertUiEnabled Then
Console.WriteLine(failMessage & vbCrLf & ex.Message)
End If
Return
End Try
Else
' Report that the required argument is not present.
Const ENTER_PARAM As String = "Enter the number of " & _
"possibilities as a command line argument."
defaultListener.Fail(ENTER_PARAM)
If Not defaultListener.AssertUiEnabled Then
Console.WriteLine(ENTER_PARAM)
End If
Return
End If
For iter = 0 To possibilities
Dim result As Decimal
Dim binomial As String
' Compute the next binomial coefficient and handle all exceptions.
Try
result = CalcBinomial(possibilities, iter)
Catch ex As Exception
Dim failMessage As String = String.Format( _
"An exception was raised when " & _
"calculating Binomial( {0}, {1} ).", _
possibilities, iter)
defaultListener.Fail(failmessage, ex.Message)
If Not defaultListener.AssertUiEnabled Then
Console.WriteLine(failMessage & vbCrLf & ex.Message)
End If
Return
End Try
' Format the trace and console output.
binomial = String.Format("Binomial( {0}, {1} ) = ", _
possibilities, iter)
defaultListener.Write(binomial)
defaultListener.WriteLine(result.ToString)
Console.WriteLine("{0} {1}", binomial, result)
Next
End Sub
Function CalcBinomial(ByVal possibilities As Decimal, _
ByVal outcomes As Decimal) As Decimal
' Calculate a binomial coefficient, and minimize the chance of overflow.
Dim result As Decimal = 1
Dim iter As Decimal
For iter = 1 To possibilities - outcomes
result *= outcomes + iter
result /= iter
Next
Return result
End Function
End Module
注解
此类的实例会自动添加到 Debug.Listeners 和 Trace.Listeners 集合中。 显式添加第二 DefaultTraceListener 个会导致调试器输出窗口中的消息重复，并且断言的消息框重复。
默认情况下， Write 和 WriteLine 方法将消息发送到 Win32 OutputDebugString 函数和 Debugger.Log 方法。
默认情况下，当 Fail 应用程序在用户界面模式下运行时， 方法会显示一个消息框;它还使用 WriteLine发出消息。
注意
和 Fail 方法调用的消息框Assert的显示取决于 是否存在DefaultTraceListener。 DefaultTraceListener如果 不在集合中Listeners，则不显示消息框。 DefaultTraceListener可以通过调用 Clear 属性上的 方法Listeners删除 (System.Diagnostics.Trace.Listeners.Clear()) 。 对于.NET Framework应用，还可以在应用的配置文件中使用 <clear> 元素和 <remove> 元素。
必须启用跟踪或调试才能使用跟踪侦听器。 以下语法特定于编译器。 如果使用 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>
<remove name="Default" />
<add name="myListener" type="System.Diagnostics.TextWriterTraceListener" initializeData="c:\myListener.log" />
</listeners>
</trace>
</system.diagnostics>
</configuration>
构造函数
| DefaultTraceListener() |
在将 DefaultTraceListener 属性值设置为其默认值的情况下，初始化 Name 类的新实例。 |
属性
| AssertUiEnabled |
获取或设置一个值，该值指示应用程序是否以用户界面模式运行。 |
| Attributes |
获取应用程序配置文件中定义的自定义跟踪侦听器特性。 (继承自 TraceListener) |
| Filter |
获取或设置跟踪侦听器的跟踪筛选器。 (继承自 TraceListener) |
| IndentLevel |
获取或设置缩进级别。 (继承自 TraceListener) |
| IndentSize |
获取或设置缩进的空格数。 (继承自 TraceListener) |
| IsThreadSafe |
获取一个值，该值指示跟踪侦听器是否是线程安全的。 (继承自 TraceListener) |
| LogFileName |
获取或设置要在其中写入跟踪或调试消息的日志文件的名称。 |
| Name |
获取或设置此 TraceListener 的名称。 (继承自 TraceListener) |
| NeedIndent |
获取或设置一个值，该值指示是否缩进输出。 (继承自 TraceListener) |
| TraceOutputOptions |
获取或设置跟踪输出选项。 (继承自 TraceListener) |
方法
适用于
线程安全性
此类是线程安全的。
