EventTypeFilter Class


The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

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

Namespace:   System.Diagnostics
Assembly:  System (in System.dll)


public class EventTypeFilter : TraceFilter


Initializes a new instance of the EventTypeFilter class.


Gets or sets the event type of the messages to trace.


Determines whether the specified object is equal to the current object.(Inherited from Object.)


Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.(Inherited from Object.)


Serves as the default hash function. (Inherited from Object.)


Gets the Type of the current instance.(Inherited from Object.)


Creates a shallow copy of the current Object.(Inherited from Object.)

System_CAPS_pubmethodShouldTrace(TraceEventCache, String, TraceEventType, Int32, String, Object[], Object, Object[])

Returns a string that represents the current object.(Inherited from Object.)

One of several different types of filters can be assigned to a trace listener through the Filter property to provide a layer of screening beyond that provided by the 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 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 ShouldTrace method, called by listeners to determine if an event should be traced, uses the value of the 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.

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

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

.NET Framework
Available since 2.0

Any public static ( Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Return to top