TraceOptions Enum

Definisi

Ruang nama:

System.Diagnostics

Rakitan:

System.Diagnostics.TraceSource.dll

Menentukan opsi data pelacakan yang akan ditulis ke output jejak.

Enumerasi ini mendukung kombinasi bitwise dari nilai yang termasuk di dalamnya.

public enum class TraceOptions

[System.Flags]
public enum TraceOptions

[<System.Flags>]
type TraceOptions = 

Public Enum TraceOptions

Warisan

Object

ValueType

Enum

TraceOptions

Atribut

FlagsAttribute

Bidang

Callstack	32	Tulis tumpukan panggilan, yang diwakili oleh nilai StackTrace pengembalian properti.
DateTime	2	Tulis tanggal dan waktu.
LogicalOperationStack	1	Tulis tumpukan operasi logis, yang diwakili oleh nilai LogicalOperationStack pengembalian properti.
None	0	Jangan menulis elemen apa pun.
ProcessId	8	Tulis identitas proses, yang diwakili oleh nilai Id pengembalian properti.
ThreadId	16	Tulis identitas utas, yang diwakili oleh nilai ManagedThreadId pengembalian properti untuk utas saat ini.
Timestamp	4	Tulis tanda waktu, yang diwakili oleh nilai GetTimestamp() pengembalian metode.

Contoh

Contoh kode berikut menunjukkan penggunaan TraceOptions enumerasi untuk mengatur TraceOutputOptions properti secara terprogram untuk pendengar pelacakan konsol. Listener pelacakan konsol adalah salah satu pendengar yang dijumlahkan dalam Listeners properti sumber pelacakan. Contoh kode ini adalah bagian dari contoh yang lebih besar yang disediakan untuk TraceSource kelas .

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

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

Keterangan

Enumerasi ini digunakan oleh pendengar pelacakan untuk menentukan opsi, atau elemen mana, yang harus disertakan dalam output jejak. Pelacakan pendengar menyimpan opsi pelacakan di TraceOutputOptions properti .

Contoh berikut menunjukkan penggunaan traceOutputOptions atribut untuk menentukan opsi output jejak untuk ConsoleTraceListener. Menggunakan file konfigurasi seperti ini hanya dimungkinkan di aplikasi .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>  

Untuk detail tentang menambahkan pendengar pelacakan ke file konfigurasi aplikasi, lihat <pendengar>.

Enumerasi TraceOptions tidak digunakan oleh kelas dan metode berikut:

• Kelas EventLogTraceListener , karena dapat menyebabkan volume data yang besar ditulis ke log.

• Metode Write dan WriteLine kelas ConsoleTraceListener, , DefaultTraceListenerdan TextWriterTraceListener .

• Metode Write dan WriteLine kelas TraceListener ketika tidak ditimpa dalam kelas turunan.