IisTraceListener Class

.NET Framework (current version)

Other Versions

Provides a listener that routes all tracing and debugging output to the IIS 7.0 infrastructure.

Namespace: System.Web
Assembly: System.Web (in System.Web.dll)

Inheritance Hierarchy

System.Object
System.MarshalByRefObject
System.Diagnostics.TraceListener
System.Web.IisTraceListener

Syntax

C++

[HostProtectionAttribute(SecurityAction.LinkDemand, Synchronization = true)]
public sealed class IisTraceListener : TraceListener

Constructors

	Name	Description
	IisTraceListener()	Initializes a new instance of the IisTraceListener class.

Properties

	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.)

Methods

	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(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.)
	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()	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)	This API supports the product infrastructure and is not intended to be used directly from your code. 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[])	This API supports the product infrastructure and is not intended to be used directly from your code. 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)	This API supports the product infrastructure and is not intended to be used directly from your code. 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[])	This API supports the product infrastructure and is not intended to be used directly from your code. 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(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.(Overrides TraceListener.Write(String).)
	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(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.(Overrides TraceListener.WriteLine(String).)
	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.