IisTraceListener Class
Provides a listener that routes all tracing and debugging output to the IIS 7.0 infrastructure.
System.MarshalByRefObject
System.Diagnostics.TraceListener
System.Web.IisTraceListener
Namespace: System.Web
Assembly: System.Web (in System.Web.dll)
The IisTraceListener type exposes the following members.
| Name | Description | |
|---|---|---|
 | Attributes | Gets the custom trace listener attributes defined in the application configuration file. (Inherited from TraceListener.) |
| Filter | Gets and 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.) |
| TraceOutputOptions | Gets or sets the trace output options. (Inherited from TraceListener.) |
| Name | Description | |
|---|---|---|
| Close | When overridden in a derived class, closes the output stream so it no longer receives tracing or debugging output. (Inherited from TraceListener.) |
| CreateObjRef | 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.) |
| 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 a hash function for a particular type. (Inherited from Object.) |
| GetLifetimeService | 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 | Obtains a lifetime service object to control the lifetime policy for this instance. (Inherited from MarshalByRefObject.) |
| ToString | Returns a string that represents the current object. (Inherited from Object.) |
| TraceData(TraceEventCache, String, TraceEventType, Int32, Object) | Infrastructure. Writes trace information, a data object, and event information to the output of the IisTraceListener class. (Overrides TraceListener.TraceData(TraceEventCache, String, TraceEventType, Int32, Object).) |
| TraceData(TraceEventCache, String, TraceEventType, Int32, Object[]) | Infrastructure. Writes trace information, an array of data objects, and event information to the output of the IisTraceListener class. (Overrides TraceListener.TraceData(TraceEventCache, String, TraceEventType, Int32, Object[]).) |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32) | Writes trace and event information to the listener specific output. (Inherited from TraceListener.) |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32, String) | Infrastructure. Writes trace and event information to the output of the IisTraceListener class. (Overrides TraceListener.TraceEvent(TraceEventCache, String, TraceEventType, Int32, String).) |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]) | Infrastructure. Writes trace information, a formatted array of objects, and event information to the output of the IisTraceListener class. (Overrides TraceListener.TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]).) |
| TraceTransfer | 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(String) | Writes the specified message to the output of the IisTraceListener class. (Overrides TraceListener.Write(String).) |
| 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, String) | Writes the specified message and the specified category name to the output of the IisTraceListener class. (Overrides TraceListener.Write(String, String).) |
| 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(String) | Writes the specified message to the output of the IisTraceListener class. (Overrides TraceListener.WriteLine(String).) |
| 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, String) | Writes the specified message and category name to the output of the IisTraceListener class. (Overrides TraceListener.WriteLine(String, String).) |
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 .NET Framework Versions and Dependencies.
| Note |
|---|
The HostProtectionAttribute attribute applied to this type or member has the following Resources property value: Synchronization. The HostProtectionAttribute does not affect desktop applications (which are typically started by double-clicking an icon, typing a command, or entering a URL in a browser). For more information, see the HostProtectionAttribute class or SQL Server Programming and Host Protection Attributes. |
Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
