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

Quita de la colección de proveedores de perfiles de usuario todas las instancias del proveedor de perfiles.

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

<clear/>

Atributos y elementos

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

Atributos

Ninguno.

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.

providers

Define una colección de proveedores de perfiles para el perfil de usuario.

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 siguiente ejemplo de código se muestra cómo configurar una aplicación ASP.NET de manera que utilice el proveedor SqlProfileProvider para almacenar y recuperar información de perfiles. El elemento <clear> borra la colección ProfileProviderCollection antes de agregar el SqlProfileProvider.

<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"
             applicationName="SampleApplication"
             enablePasswordRetrieval="true"
             enablePasswordReset="true"
             passwordFormat="Encrypted"
             requiresQuestionAndAnswer="true" />
      </providers>
    </membership>

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

      <properties>
        <add name="ZipCode" />
        <add name="CityAndState" />
      </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

ProfileSection.Providers

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 profile (Esquema de configuración de ASP.NET)

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

Elemento <configuration>

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

Elemento remove aplicado a providers 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