TraceAreaElement Class

Article
2022-06-14

Specifies criteria for generating trace events and configures the content of log file entries.

Syntax

class TraceAreaElement : CollectionElement

Methods

This class contains no methods.

Properties

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

Name	Description
`Areas`	A read/write `string` value that has a comma-delimited list, without spaces, of areas whose requests are traced when the `Provider` property is set to "ASPNET" or "WWW server". When `Provider` is set to "ASPNET," the possible values are "Infrastructure", "Module", "Page", and "AppServices". When `Provider` is set to "WWW server", the possible values are "Authentication", "Security", "Filter", "StaticFile", "CGI", "Compression", "Cache", "RequestNotifications", and "All".
`Provider`	A required unique read/write `string` value that contains the name of the provider whose failed requests are traced. The possible values are "ASP", "ASPNET", "ISAPI Extension", and "WWW Server". The key property.
`Verbosity`	A read/write `sint32` value that specifies the level of verbosity when failed requests are logged. The possible values are listed in the Remarks section below.

Subclasses

This class contains no subclasses.

Remarks

Instances of this class are contained in the TraceAreas array property of the TraceUrlAreaSettings class.

The following table lists the possible values for the Verbosity property. The default is 3 (Warning).

For a request to be marked as failed, the events raised must have a level less than or equal to the value in Verbosity. General events are excluded from this calculation.

Value	Keyword	Description
0	`General`	Provides information about the context of the request activity, such as the URL and verb for the request.
1	`CriticalError`	Provides information about actions that can cause a process to exit or that are about to cause a process to exit.
2	`Error`	Provides information about components that experience an error and cannot continue to process requests. These errors usually indicate a server-side problem.
3	`Warning`	Provides information about components that experience an error but can continue processing requests. The default.
4	`Information`	Provides general information about requests.
5	`Verbose`	Provides detailed information about requests.

Inheritance Hierarchy

CollectionElement

TraceAreaElement

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

Share via