System.Diagnostics.EventTypeFilter Class

Indicates whether a listener should trace based on the event type.

See Also: EventTypeFilter Members

Syntax

public class EventTypeFilter : TraceFilter

Remarks

One of several different types of filters can be assigned to a trace listener through the TraceListener.Filter property to provide a layer of screening beyond that provided by the System.Diagnostics.TraceSwitch. The filter can be used to control the event types that are produced by the listener.

This class filters events based on the value of the EventTypeFilter.EventType property. This property can be set by code or in a configuration file to specify the event type of messages that should be traced by the listener. The value of the property indicates the threshold at which to begin tracing. Event types at and above the specified level are traced. The TraceFilter.ShouldTrace(TraceEventCache, string, TraceEventType, int, string, Object[], object, Object[]) method, called by listeners to determine if an event should be traced, uses the value of the EventTypeFilter.EventType property.

To set the event type at which to begin tracing, edit the configuration file that corresponds to the name of your application. Within this file, you can add a listener, set its filter type, and specify the event type to trace. The configuration file should be formatted as follows.

Example

<configuration>
  <system.diagnostics>
    <sharedListeners>
      <add name="Console" type="System.Diagnostics.ConsoleTraceListener">
        <filter type="System.Diagnostics.EventTypeFilter" 
          initializeData="Warning" />
      </add>
    </sharedListeners>
  </system.diagnostics>
</configuration>

For more information about how to initialize data for an System.Diagnostics.EventTypeFilter, see <filter> Element for <add> for <sharedListeners>.

Requirements

Namespace: System.Diagnostics
Assembly: System (in System.dll)
Assembly Versions: 2.0.0.0, 4.0.0.0