ListenerElement Class
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
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 |
See Also
EmbeddedObject Class
ListenerSettings Class
SourceListenerSettings Class
TypedElement Class
System.Diagnostics.TraceEventCache Properties