remove Element for properties for profile (ASP.NET Settings Schema)
Removes a property definition from the user profile.
This element is new in the .NET Framework version 2.0.
<configuration> Element
system.web Element (ASP.NET Settings Schema)
profile Element (ASP.NET Settings Schema)
properties Element for profile (ASP.NET Settings Schema)
remove Element for properties for profile (ASP.NET Settings Schema)
<remove name="property name" />
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 definition to remove from the collection. |
Child Elements
None.
Parent Elements
Element |
Description |
|---|---|
configuration |
Specifies the required 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 |
Optional element. 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 code example demonstrates how to remove any existing profile property definition named RecentSearchList by using the <remove> element before adding a new profile property definition named RecentSearchList.
<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>
<remove name="RecentSearchList" />
<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 |
|
Configuration member |
|
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 |
See Also
Tasks
How to: Lock ASP.NET Configuration Settings
Reference
properties Element for profile (ASP.NET Settings Schema)
profile Element (ASP.NET Settings Schema)
system.web Element (ASP.NET Settings Schema)
add Element for properties for profile (ASP.NET Settings Schema)
clear Element for properties for profile (ASP.NET Settings Schema)
group Element for properties for profile (ASP.NET Settings Schema)
Concepts
ASP.NET Profile Properties Overview
ASP.NET Configuration Overview
ASP.NET Web Server Controls and Browser Capabilities
Securing ASP.NET Configuration
ASP.NET Configuration Scenarios
Other Resources
ASP.NET Configuration Settings