ListenerElement Class

Article
05/19/2022

Contains a listener that monitors and formats trace output.

Syntax

class ListenerElement : TypedElement

Methods

This class contains no methods.

Properties

The following table lists the properties exposed by the ListenerElement class.

Name	Description
`Filter`	A TypedElement value that filters the trace output.
`InitializeData`	(Inherited from `TypedElement`.)
`Name`	A required unique read/write `string` value that contains the name of the listener. The key property.
`TraceOutputOptions`	A read/write `sint32` value that specifies the kind of trace event data that is returned from a thread and a process. The possible values are listed later in the Remarks section.
`Type`	(Inherited from `TypedElement`.)

Subclasses

This class contains no subclasses.

Remarks

Instances of this class are contained in the SharedListeners array property of the ListenerSettings class and in the Listeners array property of the SourceListenerSettings class.

The following table lists the possible values for the TraceOutputOptions property. The default is 0 (None).

Value	Keyword	Description
0	`None`	No trace data is returned.
1	`LogicalOperationStack`	Returns stack data that correlates thread-bound logical operation identities with their trace events.
2	`DateTime`	Returns the date and time at which the event trace occurred.
4	`Timestamp`	Returns the current number of ticks in the timer mechanism.
8	`ProcessId`	Returns the unique identifier of the current process.
16	`ThreadId`	Returns a unique identifier for the current managed thread.
32	`Callstack`	Returns a string that contains trace information that lists the method calls on the stack. The most recent call is listed first.

Inheritance Hierarchy

EmbeddedObject

TypedElement

ListenerElement

Requirements

Type	Description
Client	- IIS 7.0 on Windows Vista - IIS 7.5 on Windows 7 - IIS 8.0 on Windows 8 - IIS 10.0 on Windows 10
Server	- IIS 7.0 on Windows Server 2008 - IIS 7.5 on Windows Server 2008 R2 - IIS 8.0 on Windows Server 2012 - IIS 8.5 on Windows Server 2012 R2 - IIS 10.0 on Windows Server 2016
Product	- IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0
MOF file	WebAdministration.mof