TraceOptions Enum
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
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
- Atribut
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
danWriteLine
kelas ConsoleTraceListener, , DefaultTraceListenerdan TextWriterTraceListener .Metode Write dan WriteLine kelas TraceListener ketika tidak ditimpa dalam kelas turunan.