Elemento remove aplicado a properties para profile (Esquema de configuración de ASP.NET)

  • Artículo

Quita una definición de propiedad del perfil de usuario.

Se trata de un elemento nuevo en .NET Framework, versión 2.0.

<remove name="property name" />

Atributos y elementos

En las secciones siguientes se describen los atributos, los elementos secundarios y los elementos primarios.

Atributos

Atributo

Descripción

name

El atributo String es obligatorio.

Especifica el nombre de la definición de propiedad que se va a quitar de la colección.

Elementos secundarios

Ninguno.

Elementos primarios

Elemento

Descripción

configuration

Especifica el elemento raíz necesario de cada archivo de configuración que utilizan las aplicaciones basadas en Common Language Runtime y .NET Framework.

system.web

Especifica el elemento raíz de la sección de configuración de ASP.NET.

profile

Configura el perfil de usuario para una aplicación.

properties

Elemento opcional.

Define una colección de propiedades de perfiles de usuario y de grupos de propiedades.

Comentarios

Para obtener información sobre cómo obtener acceso a los valores de configuración del elemento profile en el código de una aplicación, o sobre cómo modificarlos, vea ProfileSection.

Ejemplo

En el ejemplo de código siguiente se muestra cómo quitar cualquier definición de propiedad de perfil existente denominada RecentSearchList utilizando el elemento <remove> antes de agregar una nueva definición de propiedad de perfil denominada 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>

Información de elemento

Controlador de la sección de configuración

System.Web.Configuration.ProfileSection

Miembro de configuración

SystemWebSectionGroup.Profile

Ubicaciones configurables

Machine.config

Web.config del nivel raíz

Web.config del nivel de aplicaciones

Requisitos

Microsoft Internet Information Services (IIS) versión 5.0, 5.1 ó 6.0

.NET Framework versión 2.0

Microsoft Visual Studio 2005

Vea también

Tareas

Cómo: Bloquear los valores de configuración de ASP.NET

Referencia

Elemento properties para profile (Esquema de configuración de ASP.NET)

Elemento profile (Esquema de configuración de ASP.NET)

Elemento system.web (Esquema de configuración de ASP.NET)

Elemento <configuration>

Elemento add aplicado a properties para profile (Esquema de configuración de ASP.NET)

Elemento clear aplicado a properties para profile (Esquema de configuración de ASP.NET)

Elemento group aplicado a properties para profile (Esquema de configuración de ASP.NET)

ProfileSection

System.Configuration

System.Web.Configuration

Conceptos

Información general sobre las propiedades de perfil de ASP.NET

Información general sobre la configuración de ASP.NET

Controles de servidor web ASP.NET y funciones del explorador

Proteger la configuración de ASP.NET

Escenarios de configuración de ASP.NET

Otros recursos

Archivos de configuración de ASP.NET

Opciones de configuración de ASP.NET

Opciones de configuración generales (ASP.NET)

API de configuración de ASP.NET