Represents an attribute or a child of a configuration element. This class cannot be inherited.
Assembly: System.Configuration (in System.Configuration.dll)
In the case of a simple ConfigurationElement, such as the CustomSection shown in the next example, the objects represent attributes such as fileName.
In the case of more complex configuration elements such as a section containing subsections, for instance authentication, the objects can represent ConfigurationElement objects as well as attributes.
The class represents an individual configuration setting. This class allows you to get or set the name, type, and default value for a particular configuration entity (attribute or element) and specify whether the attribute is required, is an element key, or represents a default element collection.Notes to Implementers:
You can use a programmatic or a declarative (attributed) coding model to create a custom configuration element.
Programmatic Model. This model requires that you create a property for each element attribute to get and/or set its value and add it to the internal property bag of the underlying ConfigurationElement base class.
Declarative Model. This simpler model, also called attributed model, allows you to define an element attribute by using a property and decorate it with attributes. These attributes instruct the ASP.NET configuration system about the property types and their default values. With this information, obtained through reflection, the ASP.NET configuration system creates the element property objects for you and performs the required initialization.
The following code example shows how to use the when you create a custom section.
The following is an excerpt of the configuration file used by the code in the previous example.
<configuration> <configSections> <section name="CustomSection" type="ConfigurationPropertyExample.CustomSection, ConfigurationPropertyExample" allowDefinition="Everywhere" allowExeDefinition="MachineToApplication" restartOnExternalChanges="true" /> </configSections> <CustomSection fileName="override.txt" alias="alias.txt" maxUsers="1000" maxIdleTime="00:05:00" /> </configuration>
The following example shows how to create the previous section in code.
Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98
The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.