TraceListener.Filter Properti
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.
Mendapatkan atau mengatur filter pelacakan untuk pendengar pelacakan.
public:
property System::Diagnostics::TraceFilter ^ Filter { System::Diagnostics::TraceFilter ^ get(); void set(System::Diagnostics::TraceFilter ^ value); };
public System.Diagnostics.TraceFilter? Filter { get; set; }
public System.Diagnostics.TraceFilter Filter { get; set; }
[System.Runtime.InteropServices.ComVisible(false)]
public System.Diagnostics.TraceFilter Filter { get; set; }
member this.Filter : System.Diagnostics.TraceFilter with get, set
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.Filter : System.Diagnostics.TraceFilter with get, set
Public Property Filter As TraceFilter
Nilai Properti
Objek yang berasal dari TraceFilter kelas dasar.
- Atribut
Contoh
Contoh kode berikut menunjukkan cara menggunakan Filter properti untuk menambahkan filter sumber ke pendengar jejak konsol. Contoh kode ini adalah bagian dari contoh yang lebih besar yang disediakan untuk TraceSource kelas .
// Test the filter on the ConsoleTraceListener.
ts.Listeners["console"].Filter = new SourceFilter("No match");
ts.TraceData(TraceEventType.Error, 5,
"SourceFilter should reject this message for the console trace listener.");
ts.Listeners["console"].Filter = new SourceFilter("TraceTest");
ts.TraceData(TraceEventType.Error, 6,
"SourceFilter should let this message through on the console trace listener.");
' Test the filter on the ConsoleTraceListener.
ts.Listeners("console").Filter = New SourceFilter("No match")
ts.TraceData(TraceEventType.Error, 5, "SourceFilter should reject this message for the console trace listener.")
ts.Listeners("console").Filter = New SourceFilter("TraceTest")
ts.TraceData(TraceEventType.Error, 6, "SourceFilter should let this message through on the console trace listener.")
Keterangan
Filter pelacakan dapat ditambahkan ke pendengar pelacakan untuk menyediakan lapisan penyaringan di luar yang disediakan untuk sumber pelacakan dengan sakelar. Misalnya, EventTypeFilter dapat ditambahkan ke pendengar pelacakan untuk mengontrol jenis peristiwa yang dihasilkan oleh pendengar. Pendengar yang dipanggil karena kriteria pengalihan terpenuhi dapat mengkueri filternya, jika ada, untuk menentukan apakah jejak akan dikirim ke output.