IisTraceListener Class
Provides a listener that routes all tracing and debugging output to the IIS 7.0 infrastructure.
System.Object
System.MarshalByRefObject
System.Diagnostics.TraceListener
System.Web.IisTraceListener
System.MarshalByRefObject
System.Diagnostics.TraceListener
System.Web.IisTraceListener
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.) |
|
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.) |
| 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.) |
|
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.) |
|
|
Finalize | Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.) |
|
|
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.) |
|
|
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) | 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).) |
|
|
WriteIndent | Writes the indent to the listener you create when you implement this class, and resets the NeedIndent property to false. (Inherited from TraceListener.) |
|
|
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 version 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 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
