This project has moved and is read-only. For the latest updates, please go here.

ExpressionFilter Class

Trace filter that evaluates a user-supplied boolean expression.


Install via NuGet (this package is automatically installed when you install one of the trace listeners):


The initalizeData for the filter contains the C# expression that is evaluated. The expression must return a boolean result and can use any of the parameters: Source, EventType, Id, Format, Callstack, DateTime, LogicalOperationStack, ProcessId, ThreadId,

You can also use an C# expression, including accessing environment details. The expression is compiled in memory, then evaluated to filter each message.

Config Attributes

Attribute Description
initializeData Boolean C# expression to evaluate, e.g. " Id == 1001 ".

Expression Parameters

The following simple parameter variables may be used in the expression:

Parameter Description
Callstack Program call stack as a string.
DateTime DateTimeOffset of the log event, in the UTC (+0) timezone.
EventType TraceEventType, e.g. Verbose, Information, Warning, Error, Critical, or one of the activity tracing events.
Format Format string (without arguments) or message.
Id Id of the event.
LogicalOperationStack Stack of objects from Trace.CorrelationManager.StartLogicalOperation().
ProcessId Id of the current process.
Source Name of the trace source the event is from.
ThreadId The current thread id.
Timestamp A numeric timestamp.

You can also use C# code and .NET functions in the expression.

Example Config

<?xml version="1.0" encoding="utf-8" ?>
      <add name="coloredconsole"
           type="Essential.Diagnostics.ColoredConsoleTraceListener, Essential.Diagnostics.ColoredConsoleTraceListener">
        <filter type="Essential.Diagnostics.ExpressionFilter, Essential.Diagnostics.Core"
                initializeData=' Id >= 8000 || System.Threading.Thread.CurrentPrincipal.Identity.Name == "User1" ' />
      <source name="ExampleSource" switchValue="All">
          <clear />
          <add name="coloredconsole" />

Last edited Feb 6 at 5:54 AM by sgryphon, version 5


No comments yet.