TraceOptions 列舉

定義

命名空間:

System.Diagnostics

組件:

System.Diagnostics.TraceSource.dll

指定要寫入至追蹤輸出的追蹤資料選項。

此列舉支援其成員值的位元組合。

public enum class TraceOptions

[System.Flags]
public enum TraceOptions

[<System.Flags>]
type TraceOptions = 

Public Enum TraceOptions

繼承

Object

ValueType

Enum

TraceOptions

屬性

FlagsAttribute

欄位

Callstack	32	寫入呼叫堆疊，它是以 StackTrace 屬性的傳回值來表示。
DateTime	2	寫入日期和時間。
LogicalOperationStack	1	寫入邏輯作業堆疊，它是以 LogicalOperationStack 屬性的傳回值來表示。
None	0	不要寫入任何項目。
ProcessId	8	寫入處理序識別，它是以 Id 屬性的傳回值來表示。
ThreadId	16	寫入執行緒識別，它是以目前執行緒之 ManagedThreadId 屬性的傳回值來表示。
Timestamp	4	寫入時間戳記，它是以 GetTimestamp() 方法的傳回值來表示。

範例

下列程式代碼範例示範如何使用 TraceOptions 列舉，以程式設計方式設定 TraceOutputOptions 主控台追蹤接聽程式的屬性。 主控台追蹤接聽程式是在追蹤來源的 屬性中 Listeners 列舉的其中一個接聽程式。 此程式代碼範例是針對 類別提供的較大範例的 TraceSource 一部分。

ts.Listeners["console"].TraceOutputOptions |= TraceOptions.Callstack;

ts.Listeners("console").TraceOutputOptions = ts.Listeners("console").TraceOutputOptions Or TraceOptions.Callstack

備註

追蹤接聽程式會使用此列舉來判斷追蹤輸出中應該包含哪些選項或元素。 追蹤接聽程式會將追蹤選項儲存在屬性中 TraceOutputOptions 。

下列範例示範如何使用 traceOutputOptions 屬性來指定 的 ConsoleTraceListener追蹤輸出選項。 只有在 .NET Framework 應用程式中，才能使用類似這樣的組態檔。

<configuration>  
  <system.diagnostics>  
    <trace autoflush="false" indentsize="4">  
      <listeners>  
        <add name="consoleListener"  
          type="System.Diagnostics.ConsoleTraceListener"   
          traceOutputOptions="ProcessId, DateTime" />  
      </listeners>  
    </trace>  
  </system.diagnostics>  
</configuration>  

如需將追蹤接聽程式新增至應用程式組態檔的詳細資訊，請參閱 <接聽程式>。

TraceOptions下列類別和方法不會使用列舉：

• 類別 EventLogTraceListener ，因為它可能會導致大量數據寫入記錄檔。

• WriteWriteLine、 DefaultTraceListener和類別的 ConsoleTraceListener和 TextWriterTraceListener 方法。

• Write在衍生類別中未覆寫類別時，類別的 TraceListener 和 WriteLine 方法。