ProfileElement Class [IIS 7 and higher]

Configures an event profile that determines how an event is collected by ASP.NET and raised to providers.

Syntax

class ProfileElement : CollectionElement

Methods

This class contains no methods.

Properties

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

Name

Description

Custom

A read/write string value that specifies the fully qualified type of a custom class that implements the IWebEventCustomEvaluator interface. The default is an empty string ("").

The type reference is formed as follows (items in brackets are not required): Namespace.Typename, Assemblyname[,] [Version=x,] [Culture=y,] [PublicKeyToken=z] (for example, "ExampleNamespace.ExampleType, Example.Assembly, Version=%ASSEMBLY_VERSION%, Culture=neutral, PublicKeyToken=%MICROSOFT_PUBLICKEY%").

NoteNote:
This property is new in the .NET Framework version 2.0.

MaxLimit

A read/write sint32 value that specifies the maximum number of times that events of the same type are raised. The default is 2147483647. For example, if the value is 10, the event will be raised 10 times and ignored thereafter.

This property must have a value greater than 0. You can make the value infinite by setting it to MaxValue. Invalid values may cause an exception to be thrown when the configuration section is saved.

MinInstances

A read/write sint32 value that specifies the minimum number of event occurrences before the event is raised to the provider. The default is 1. For example, a value of 5 means that ASP.NET will not raise an event to the provider until the fifth instance of the event occurs.

This property must have a value greater than 0. You can make the value infinite by setting it to MaxValue. If the value is MaxValue, no event will be raised to the provider. Invalid values may cause an exception to be thrown when the configuration section is saved.

MinInterval

A read/write datetime value that specifies the minimum interval between two events of the same type. The default is 0 seconds.

You can make the value infinite by setting it to MaxValue. If the value is 0, there is no minimum interval. Invalid values may cause an exception to be thrown when the configuration section is saved.

Name

A unique read-only string value that specifies the name of the profile setting. Duplicate profile setting names may cause a loss of data when the configuration section is saved. The key property.

Subclasses

This class contains no subclasses.

Remarks

Instances of this class are contained in the Profiles array property of the ProfileSettings class.

Inheritance Hierarchy

CollectionElement

   ProfileElement

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]

ProfileSettings Class [IIS 7 and higher]

ProfileSettings

IWebEventCustomEvaluator

Other Resources

System.Int32.MaxValue Field

CIM_DATETIME