TraceAreaDefinition Class

Article
05/19/2022

Specifies trace area names and their corresponding enumeration values for a trace provider.

Syntax

class TraceAreaDefinition : CollectionElement

Methods

This class contains no methods.

Properties

The following table lists the properties exposed by the TraceAreaDefinition class.

Name	Description
`Name`	A required unique read/write `string` value that specifies the name of the trace area. The key property.
`Value`	A read/write `uint32` value that maps to a trace area or areas. You can define one or more trace areas by specifying the flag number. The possible values are listed later in the Remarks section.

Subclasses

This class contains no subclasses.

Remarks

Instances of this class are contained in the Areas array property of the TraceAreaSettings class.

The failed-request tracing feature of IIS 7 uses the TraceAreaDefinition class. The property values of this class map to the same values for the areas used by the Event Tracing for Windows (ETW) providers. Trace areas are defined by default for the "WWW Server" and "ASPNET" trace providers in the ApplicationHost.config file.

The following table lists the possible values for the Value property.

Value	Keyword
2	`Authentication`
4	`Security`
8	`Filter`
16	`StaticFile`
32	`CGI`
64	`Compression`
128	`Cache`
256	`RequestNotifications`
512	`Module`

Note

There is no UrlFilter area as there is in ETW for Windows Server 2003 SP1.

Inheritance Hierarchy

CollectionElement

TraceAreaDefinition

Requirements

Type	Description
Client	- IIS 7.0 on Windows Vista - IIS 7.5 on Windows 7 - IIS 8.0 on Windows 8 - IIS 10.0 on Windows 10
Server	- IIS 7.0 on Windows Server 2008 - IIS 7.5 on Windows Server 2008 R2 - IIS 8.0 on Windows Server 2012 - IIS 8.5 on Windows Server 2012 R2 - IIS 10.0 on Windows Server 2016
Product	- IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0
MOF file	WebAdministration.mof