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

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.

<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 EventTypeFilter, see <filter> Element for <add> for <sharedListeners>.

System.Object
  System.Diagnostics.TraceFilter
    System.Diagnostics.EventTypeFilter

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

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

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

.NET Framework

Supported in: 3.5, 3.0, 2.0
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft