IisTraceListener Class
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Provides a listener that routes all tracing and debugging output to the IIS 7.0 infrastructure.
public ref class IisTraceListener sealed : System::Diagnostics::TraceListenerpublic sealed class IisTraceListener : System.Diagnostics.TraceListenertype IisTraceListener = class
inherit TraceListenerPublic NotInheritable Class IisTraceListener
Inherits TraceListener- Inheritance
Remarks
The IisTraceListener class connects the tracing mechanism of ASP.NET to IIS 7.0. This listener class enables developers who create ASP.NET applications and who implement the IHttpModule and IHttpHandler interfaces to raise page-level, module-level, or handler-level events to the IIS 7.0 infrastructure when tracing is enabled.
Note
This listener class does not route IIS 7.0 events to ASP.NET classes. This includes the Page class and classes that implement the IHttpModule or IHttpHandler interface.
IisTraceListener is introduced in the .NET Framework 3.5. For more information, see Versions and Dependencies.
Constructors
| IisTraceListener() |
Initializes a new instance of the IisTraceListener class. |
Properties
| Attributes |
Gets the custom trace listener attributes defined in the application configuration file. (Inherited from TraceListener) |
| Filter |
Gets or sets the trace filter for the trace listener. (Inherited from TraceListener) |
| IndentLevel |
Gets or sets the indent level. (Inherited from TraceListener) |
| IndentSize |
Gets or sets the number of spaces in an indent. (Inherited from TraceListener) |
| IsThreadSafe |
Gets a value indicating whether the trace listener is thread safe. (Inherited from TraceListener) |
| Name |
Gets or sets a name for this TraceListener. (Inherited from TraceListener) |
| NeedIndent |
Gets or sets a value indicating whether to indent the output. (Inherited from TraceListener) |
| TraceOutputOptions |
Gets or sets the trace output options. (Inherited from TraceListener) |
Methods
| Close() |
When overridden in a derived class, closes the output stream so it no longer receives tracing or debugging output. (Inherited from TraceListener) |
| CreateObjRef(Type) |
Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object. (Inherited from MarshalByRefObject) |
| Dispose() |
Releases all resources used by the TraceListener. (Inherited from TraceListener) |
| Dispose(Boolean) |
Releases the unmanaged resources used by the TraceListener and optionally releases the managed resources. (Inherited from TraceListener) |
| Equals(Object) |
Determines whether the specified object is equal to the current object. (Inherited from Object) |
| Fail(String) |
Emits an error message to the listener you create when you implement the TraceListener class. (Inherited from TraceListener) |
| Fail(String, String) |
Emits an error message and a detailed error message to the listener you create when you implement the TraceListener class. (Inherited from TraceListener) |
| Flush() |
When overridden in a derived class, flushes the output buffer. (Inherited from TraceListener) |
| GetHashCode() |
Serves as the default hash function. (Inherited from Object) |
| GetLifetimeService() |
Obsolete.
Retrieves the current lifetime service object that controls the lifetime policy for this instance. (Inherited from MarshalByRefObject) |
| GetSupportedAttributes() |
Gets the custom attributes supported by the trace listener. (Inherited from TraceListener) |
| GetType() |
Gets the Type of the current instance. (Inherited from Object) |
| InitializeLifetimeService() |
Obsolete.
Obtains a lifetime service object to control the lifetime policy for this instance. (Inherited from MarshalByRefObject) |
| MemberwiseClone() |
Creates a shallow copy of the current Object. (Inherited from Object) |
| MemberwiseClone(Boolean) |
Creates a shallow copy of the current MarshalByRefObject object. (Inherited from MarshalByRefObject) |
| ToString() |
Returns a string that represents the current object. (Inherited from Object) |
| TraceData(TraceEventCache, String, TraceEventType, Int32, Object) |
Writes trace information, a data object, and event information to the output of the IisTraceListener class. |
| TraceData(TraceEventCache, String, TraceEventType, Int32, Object[]) |
Writes trace information, an array of data objects, and event information to the output of the IisTraceListener class. |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32) |
Writes trace and event information to the listener specific output. (Inherited from TraceListener) |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32, String) |
Writes trace and event information to the output of the IisTraceListener class. |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]) |
Writes trace information, a formatted array of objects, and event information to the output of the IisTraceListener class. |
| TraceTransfer(TraceEventCache, String, Int32, String, Guid) |
Writes trace information, a message, a related activity identity and event information to the listener specific output. (Inherited from TraceListener) |
| Write(Object) |
Writes the value of the object's ToString() method to the listener you create when you implement the TraceListener class. (Inherited from TraceListener) |
| Write(Object, String) |
Writes a category name and the value of the object's ToString() method to the listener you create when you implement the TraceListener class. (Inherited from TraceListener) |
| Write(String) |
Writes the specified message to the output of the IisTraceListener class. |
| Write(String, String) |
Writes the specified message and the specified category name to the output of the IisTraceListener class. |
| WriteIndent() |
Writes the indent to the listener you create when you implement this class, and resets the NeedIndent property to |
| WriteLine(Object) |
Writes the value of the object's ToString() method to the listener you create when you implement the TraceListener class, followed by a line terminator. (Inherited from TraceListener) |
| WriteLine(Object, String) |
Writes a category name and the value of the object's ToString() method to the listener you create when you implement the TraceListener class, followed by a line terminator. (Inherited from TraceListener) |
| WriteLine(String) |
Writes the specified message to the output of the IisTraceListener class. |
| WriteLine(String, String) |
Writes the specified message and category name to the output of the IisTraceListener class. |
