Para ver el artículo en inglés, active la casilla Inglés. También puede ver el texto en inglés en una ventana emergente si pasa el puntero del mouse por el texto.
Traducción
Inglés
Esta documentación está archivada y no tiene mantenimiento.

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

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>

En las secciones siguientes 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.

El valor predeterminado 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 Información general sobre las propiedades de perfil de ASP.NET.

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.

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>

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>

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

Mostrar: