This documentation is archived and is not being maintained.

EventTypeFilter Class

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


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

public class EventTypeFilter : TraceFilter

The EventTypeFilter type exposes the following members.

Public methodEventTypeFilterInitializes a new instance of the EventTypeFilter class.

Public propertyEventTypeGets or sets the event type of the messages to trace.

Public methodEquals(Object)Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
Protected methodFinalizeAllows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
Public methodGetHashCodeServes as a hash function for a particular type. (Inherited from Object.)
Public methodGetTypeGets the Type of the current instance. (Inherited from Object.)
Protected methodMemberwiseCloneCreates a shallow copy of the current Object. (Inherited from Object.)
Public methodShouldTraceDetermines whether the trace listener should trace the event. (Overrides TraceFilter.ShouldTrace(TraceEventCache, String, TraceEventType, Int32, String, Object[], Object, Object[]).)
Public methodToStringReturns 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

Supported in: 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

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