ListenerElement Class [IIS 7 and higher]
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 |
Requires IIS 7 on Windows Vista. |
Server |
Requires IIS 7 on Windows Server 2008. |
Product |
IIS 7 |
MOF file |
WebAdministration.mof |
See Also
Reference
EmbeddedObject Class [IIS 7 and higher]
ListenerSettings Class [IIS 7 and higher]
SourceListenerSettings Class [IIS 7 and higher]
TypedElement Class [IIS 7 and higher]