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) 方法會將結果寫入記錄檔。
Fail、 Write與 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 屬性值設為 "Default")。 |
屬性
| AssertUiEnabled |
取得或設定值，表示應用程式是否正在使用者介面模式下執行。 |
| Attributes |
取得在應用程式組態檔中定義的自訂追蹤接聽程式屬性。 (繼承來源 TraceListener) |
| Filter |
取得或設定追蹤接聽程式的追蹤篩選。 (繼承來源 TraceListener) |
| IndentLevel |
取得或設定縮排層級。 (繼承來源 TraceListener) |
| IndentSize |
取得或設定縮排的空格數目。 (繼承來源 TraceListener) |
| IsThreadSafe |
取得值，指出追蹤接聽程式是否為安全執行緒。 (繼承來源 TraceListener) |
| LogFileName |
取得或設定要寫入追蹤或偵錯訊息的記錄檔名稱。 |
| Name |
取得或設定這個 TraceListener 的名稱。 (繼承來源 TraceListener) |
| NeedIndent |
取得或設定值，指出是否要縮排輸出。 (繼承來源 TraceListener) |
| TraceOutputOptions |
取得或設定追蹤輸出選項。 (繼承來源 TraceListener) |
方法
適用於
執行緒安全性
這個類別是安全線程。
