ProfileElement Class

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 System.Web.Management.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%"). Note: 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 - 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

See Also

System.Web.Configuration.ProfileSettings System.Web.Management.IWebEventCustomEvaluator CollectionElement Class
ProfileSettings Class
System.Int32.MaxValue Field
CIM_DATETIME