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

Article
04/30/2007

Adds a property to the user profile.

This element is new in the .NET Framework version 2.0.

<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 about 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 the provider 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 about 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 specific. 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, as follows: 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, the String null value 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 that the customProviderData attribute can be set to any string value to be used by the profile provider for the property. If this 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.

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 a ZipCode property of type string and a RecentSearchList property of type StringCollection. The generated Profile property will have strongly typed accessors for each of the specified properties. For information about the user profile and an example of setting and reading user profile properties, see ASP.NET Profile Properties.

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

  <system.web>
   <anonymousIdentification enabled="true" />

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

     <properties>
       <add name="ZipCode" allowAnonymous="true" />
       <add name="RecentSearchList"
            type="System.Collections.Specialized.StringCollection"
            serializeAs="Xml"
            allowAnonymous="true" />
      </properties>
    </profile>
   </system.web>
</configuration>

Element Information

Configuration section handler	System.Web.Configuration.ProfileSection
Configuration member	System.Web.Configuration.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

Partager via

add Element for properties 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

Ressources supplémentaires