TraceAreaElement Class [IIS 7 and higher]
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
TraceAreaElement
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]
HttpTracingSection Class [IIS 7 and higher]
TraceAreaDefinition 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]
TraceUrlAreaSettings Class [IIS 7 and higher]