System.Web 2.0.0.0 System.Configuration.ConfigurationElement

The class provides a way to programmatically create, access, and modify the definition of an individual property added to the properties subsection of the profile section of a configuration file.

The profile section of the configuration file specifies a schema for user profiles. At run time, the ASP.NET compilation system uses the information specified in the profile section to generate a class called ProfileCommon, which is derived from . The ProfileCommon class definition is based on the properties defined in the properties subsection of the profile section of the configuration file. An instance of this class is created for each user profile, and you can access the individual profile values in your code through the property. For more information about profile properties, see Understanding ASP.NET Profile Properties. For more information about the profile features added to vstecasplong, see ASP.NET Profile Properties Overview.

The class provides a way to programmatically access and modify the profiles section of a configuration file. This class cannot be inherited.

- Constructor

  The following table shows the default settings that are used for this constructor.

  Setting

  Default Value

  false.

  An empty string ("").

  false.

  .

  An empty string ("").

  Initializes a new instance of the class with the specified name.

  A unique name for the object.
  2.0.0.0
- Constructor

  At run time, the ASP.NET compilation system uses the information specified in the profile section of the configuration file to generate a class called ProfileCommon, which is derived from . The class allows you to access and modify the values for individual user profiles.

  The ProfileCommon class definition is based on the properties defined in the properties subsection of the profile section of the configuration file. The parameter values that you specify when you create an instance of the class will be used to define an associated property in the ProfileCommon class.

  For more information about profile properties, see Understanding ASP.NET Profile Properties.

  Initializes a new instance of the class with the specified name and settings.

  A unique name for the object.
  true to indicate that the associated property in the dynamically generated ProfileCommon class should be read-only; otherwise, false.
  One of the values.
  The name of a provider from the property, or an empty string ("").
  A string containing the default value used for the named property in the generated page Profile class.
  A valid type reference or an empty string.
  true to indicate associated property in the dynamically generated ProfileCommon class should support anonymous users; otherwise, false, to indicate that anonymous users cannot change the named property.
  A string containing provider-specific information used by the provider associated with the property.
  2.0.0.0
- Property
  System.Configuration.ConfigurationProperty("allowAnonymous", DefaultValue=false)
  System.Boolean To be added.

  At run time, the ASP.NET compilation system uses the information specified in the profile section of the configuration file to generate a class called ProfileCommon, which is derived from . The class allows you to access and modify the values for individual user profiles.

  The ProfileCommon class definition is based on the properties defined in the properties subsection of the profile section of the configuration file. The property values that you specify for an instance of the class will be used to define an associated property in the ProfileCommon class.

  An exception is thrown if a property in the ProfileCommon class is changed by an anonymous user when the property value is false.

  Gets or sets a value indicating whether the associated property in the dynamically generated ProfileCommon class can be set by anonymous users.

  2.0.0.0
- Property
  System.Configuration.ConfigurationProperty("customProviderData", DefaultValue="")
  System.String To be added. To be added.

  Gets or sets a string of custom data for the profile property provider.

  2.0.0.0
- Property
  System.Configuration.ConfigurationProperty("defaultValue", DefaultValue="")
  System.String To be added.

  At run time, the ASP.NET compilation system uses the information specified in the profile section of the configuration file to generate a class called ProfileCommon, which is derived from . The class allows you to access and modify the values for individual user profiles.

  The ProfileCommon class definition is based on the properties defined in the properties subsection of the profile section of the configuration file. The property values that you specify for an instance of the class will be used to define an associated property in the ProfileCommon class.

  The default value is used as the initial value for the associated ProfileCommon class property when an individual user profile does not contain a value for the property. The property may be a string value, an XML-encoded value (serialization mode for the property is XML serialization) or a base-64-encoded binary string (if the serialization mode for the property is binary serialization).

  Gets or sets the default value used for the associated property in the dynamically generated ProfileCommon class.

  2.0.0.0
- Property
  System.Configuration.ConfigurationProperty("name", Options=System.Configuration.ConfigurationPropertyOptions.IsRequired | System.Configuration.ConfigurationPropertyOptions.IsKey)
  System.String To be added.

  At run time, the ASP.NET compilation system uses the information specified in the profile section of the configuration file to generate a class called ProfileCommon, which is derived from . The class allows you to access and modify the values for individual user profiles.

  The ProfileCommon class definition is based on the properties defined in the properties subsection of the profile section of the configuration file. The property values that you specify for an instance of the class will be used to define an associated property in the ProfileCommon class.

  Gets or sets the name of the object and the associated property in the dynamically generated ProfileCommon class.

  2.0.0.0
- Property
  System.Configuration.ConfigurationPropertyCollection To be added. To be added. To be added. 2.0.0.0
- Property
  System.Configuration.ConfigurationProperty("provider", DefaultValue="")
  System.String To be added.

  Profile providers are data sources in which user-profile values are stored. You can specify profile providers in the providers subsection of the profile section of a configuration file.

  If the value of this property is an empty string, the default provider specified in the property is used.

  Gets or sets the name of a provider to use when serializing the named property.

  2.0.0.0
- Property
  System.Configuration.ConfigurationProperty("readOnly", DefaultValue=false)
  System.Boolean To be added.

  At run time, the ASP.NET compilation system uses the information specified in the profile section of the configuration file to generate a class called ProfileCommon, which is derived from . The class allows you to access and modify the values for individual user profiles.

  The ProfileCommon class definition is based on the properties defined in the properties subsection of the profile section of the configuration file. The property values that you specify for an instance of the class will be used to define an associated property in the ProfileCommon class.

  Gets or sets a value that determines whether the associated property in the dynamically generated ProfileCommon class is read-only.

  2.0.0.0
- Property
  System.Configuration.ConfigurationProperty("serializeAs", DefaultValue="ProviderSpecific")
  System.Web.Configuration.SerializationMode To be added.

  For more information about profile properties, see Understanding ASP.NET Profile Properties.

  Gets or sets the serialization method used for the associated property in the dynamically generated ProfileCommon class.

  2.0.0.0
- Property
  System.Configuration.ConfigurationProperty("type", DefaultValue="string")
  System.String To be added.

  When set to a valid type reference, this type is used for the named property in the generated ProfileCommon class.

  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%"

  Gets or sets the name of the type of the associated property in the dynamically generated ProfileCommon class.

  2.0.0.0