add Element for group for profile (ASP.NET Settings Schema)

Article
12/21/2012

Adds a property to a user profile group.

<configuration> Element
  system.web Element (ASP.NET Settings Schema)
    profile Element (ASP.NET Settings Schema)
      properties Element for profile (ASP.NET Settings Schema)
        group Element for properties for profile (ASP.NET Settings Schema)
          add Element for group for profile (ASP.NET Settings Schema)

<add 
    name="property name" 
    type="fully qualified type reference"
    provider="provider name"
    serializeAs="String|Xml|Binary|ProviderSpecific"
    allowAnonymous="true|false"
    defaultValue="default property value"
    readOnly="true|false"
    customProviderData="data for a custom profile provider" />
/>

Attributes and Elements

The following sections describe attributes, child elements, and parent elements.

Attributes

Attribute	Description
name	Required String attribute. Specifies the name of the property. This value is used as the name of the property for the automatically generated profile class and as the index value for the property in the Properties collection. The name of the property cannot contain a period (.). For more information on the automatic generation of user profile properties, see ASP.NET Profile Properties Overview.
type	Optional String attribute. Specifies the type of the property. The default is String.
provider	Optional String attribute. Specifies the profile provider that is used to store and retrieve values for the property. The value of this attribute is the name of one of the profile providers that are specified in the providers element. If no provider name is specified, the default provider that is specified in the profile element is used. For more information on profile providers, see ASP.NET Profile Providers.
serializeAs	Optional SettingsSerializeAs attribute. Specifies the serialization format for the property value in the data store. The default serialization format is specific to the provider. The actual serialization that is used is determined by the provider, which is String serialization in the case of the SQL provider.
allowAnonymous	Optional Boolean attribute. Specifies whether the property can be get or set, if the application user is anonymous. If set to true, the property can be get or set if the application user is anonymous. The default is false.
defaultValue	Optional String attribute. Specifies the default value, if there is no value for the Profile property in the data store. If the type of the property is serialized using XML serialization, this attribute can be set to an XML string that represents a serialized instance of the property type. If the type of the property is serialized using binary serialization, this attribute can be set to a base-64 encoded string that represents a serialized instance of the property type. If the property is a reference type, string null can be used to indicate that the Profile property should return null for noninitialized profiles.
readOnly	Optional Boolean attribute. Specifies whether the property can be read, but not set. If set to true, the property can be read, but not set. The default is false.
customProviderData	Optional String attribute. Specifies the string value to be used by the profile provider for the property. This attribute can be set to any string value. If the customProviderData attribute is set, the value is placed in the Attributes collection for the property and is indexed by the name "CustomProviderData".

Child Elements

None.

Parent Elements

Element	Description
configuration	Specifies the root element in every configuration file that is used by the common language runtime and the .NET Framework applications.
system.web	Specifies the root element for the ASP.NET configuration section.
profile	Configures the user profile for an application.
properties	Defines a collection of user profile properties and property groups.
group	Defines a grouping of user profile properties.

Remarks

For information about accessing and modifying configuration values for the profile element in application code, see ProfileSection.

Example

The following example Web.config file demonstrates how to specify a user profile that contains group of properties with a group name of Address. The grouped properties that are generated for the Profile property will be preceded by the group name (for example, Profile.Address.Street). For information about the user profile and an example of setting and reading user profile property groups, see ASP.NET Profile Properties Overview.

<configuration>
   <connectionStrings>
       <add name="SqlServices" connectionString="Data Source=localhost;Integrated Security=SSPI;Initial 
            Catalog=aspnetdb;" />
   </connectionStrings>

  <system.web>
      <authentication mode="Forms" >
        <forms loginUrl="login.aspx"
             name=".ASPXFORMSAUTH" />
      </authentication>

       <authorization>
          <deny users="?" />
       </authorization>

      <membership defaultProvider="SqlProvider" userIsOnlineTimeWindow="15">
        <providers>
          <clear />
          <add 
            name="SqlProvider" 
            type="System.Web.Security.SqlMembershipProvider" 
            connectionStringName="SqlServices"
            enablePasswordRetrieval="false"
            enablePasswordReset="true"
            requiresQuestionAndAnswer="true" 
            requiresUniqueEmail="false"
            passwordFormat="Hashed"
            applicationName="MyApplication" />
        </providers>
      </membership>

      <profile defaultProvider="SqlProvider">
        <providers>
          <add
            name="SqlProvider"
            connectionStringName="SqlServices"
            applicationName="MyApplication"
            type="System.Web.Profile.SqlProfileProvider" />
        </providers>

        <properties>
          <add name="ZipCode" />
          <group name="Address">
             <add name="Street" />
             <add name="City" />
             <add name="State" />
             <add name="CountryOrRegion" />
          </group>
        </properties>
      </profile>
   </system.web>
</configuration>

Element Information

Configuration section handler	System.Web.Configuration.ProfileSection
Configuration member	SystemWebSectionGroup.Profile
Configurable locations	Machine.config Root-level Web.config Application-level Web.config
Requirements	Microsoft Internet Information Services (IIS) version 5.0, 5.1, or 6.0 The .NET Framework version 2.0 Microsoft Visual Studio 2005

add Element for group for profile (ASP.NET Settings Schema)

Attributes and Elements

Attributes

Child Elements

Parent Elements

Remarks

Example

Element Information

See Also

Tasks

Reference

Concepts

Other Resources

Additional resources