EventTypeFilter Class

Definition

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

public ref class EventTypeFilter : System::Diagnostics::TraceFilter
public class EventTypeFilter : System.Diagnostics.TraceFilter
type EventTypeFilter = class
    inherit TraceFilter
Public Class EventTypeFilter
Inherits TraceFilter
Inheritance
EventTypeFilter

Remarks

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, for .NET Framework apps, 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 in a .NET Framework app, 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>.

Constructors

EventTypeFilter(SourceLevels)

Initializes a new instance of the EventTypeFilter class.

Properties

EventType

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

Methods

Equals(Object)

Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode()

Serves as the default hash function.

(Inherited from Object)
GetType()

Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone()

Creates a shallow copy of the current Object.

(Inherited from Object)
ShouldTrace(TraceEventCache, String, TraceEventType, Int32, String, Object[], Object, Object[])

Determines whether the trace listener should trace the event.

ToString()

Returns a string that represents the current object.

(Inherited from Object)

Applies to