Share via

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

  • Artículo

[Esta documentación se proporciona solo para fines preliminares y está sujeta a cambios en versiones posteriores. Se incluye temas en blanco como marcadores].

Configura los parámetros para administrar los valores de los perfiles de usuario mediante el perfil de ASP.NET.

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

<profile
    enabled="true|false"
    inherits="fully qualified type reference"
    automaticSaveEnabled="true|false"
    defaultProvider="provider name">
    <properties>...</properties>
    <providers>...</providers>
</profile>

Atributos y elementos

En las próximas secciones se describen los atributos, los elementos secundarios y los elementos primarios.

Atributos

Atributo

Descripción

enabled

Atributo Boolean opcional.

Especifica si los perfiles de usuario de ASP.NET están habilitados. Si es true, los perfiles de usuario de ASP.NET están habilitados.

De manera predeterminada, es true.

defaultProvider

Atributo String opcional.

Especifica el nombre del proveedor de perfiles predeterminado.

Para obtener más información, vea Provider.

El valor predeterminado es AspNetSqlProfileProvider.

inherits

Atributo String opcional.

Contiene una referencia de tipo de un tipo personalizado que procede de la clase abstracta ProfileBase. ASP.NET genera de manera dinámica una clase ProfileCommon que hereda de este tipo y la coloca en la propiedad Profile del HttpContext actual.

automaticSaveEnabled

Atributo Boolean opcional.

Especifica si el perfil de usuario actual se guarda automáticamente al finalizar la ejecución de una página ASP.NET. Si es true, el perfil de usuario se guarda automáticamente al finalizar la ejecución de una página ASP.NET.

El objeto ProfileModule guarda un perfil de usuario sólo si el módulo detecta que el perfil se ha modificado. Es decir, si la propiedad IsDirty es true. Para obtener más información, vea ASP.NET Profile Properties Overview.

De manera predeterminada, es true.

Elementos secundarios

Elemento

Descripción

properties

Elemento necesario.

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

providers

Elemento opcional.

Define una colección de proveedores de perfiles.

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.

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.

Configuración predeterminada

En la versión 2.0 de .NET Framework, el siguiente elemento profile predeterminado se configura en el archivo Machine.config.

<profile>
  <providers>
        <add name="AspNetSqlProfileProvider" connectionStringName="LocalSqlServer" applicationName="/" type="System.Web.Profile.SqlProfileProvider, System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" /> 
  </providers>
</profile>

Ejemplo

En el ejemplo de código siguiente se muestra cómo configurar el archivo Web.config para una aplicación ASP.NET de manera que use un proveedor 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

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

How to: Lock ASP.NET Configuration Settings

Referencia

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

Elemento <configuration>

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

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

ProfileSection

System.Configuration

System.Web.Configuration

Conceptos

ASP.NET Profile Properties Overview

ASP.NET Configuration Overview

ASP.NET Server Controls and Browser Capabilities

Securing Configuration

Configuration Inheritance

Otros recursos

ASP.NET Configuration Files

Opciones de configuración de ASP.NET

Opciones de configuración generales (ASP.NET)

ASP.NET Configuration API