Share via


TraceAreaDefinition Class [IIS 7 and higher]

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

Requires IIS 7 on Windows Vista.

Server

Requires IIS 7 on Windows Server 2008.

Product

IIS 7

MOF file

WebAdministration.mof

See Also

Reference

CollectionElement Class [IIS 7 and higher]

FailureDefinition Class [IIS 7 and higher]

HttpTracingSection Class [IIS 7 and higher]

TraceAreaElement Class [IIS 7 and higher]

TraceAreaSettings Class [IIS 7 and higher]

TraceFailedRequestsSection Class [IIS 7 and higher]

TraceProviderDefinition Class [IIS 7 and higher]

TraceProviderDefinitionsSection Class [IIS 7 and higher]

TraceUrl Class [IIS 7 and higher]

Other Resources

Create a Tracing Rule for Failed Requests