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

Artículo
09/05/2008

Actualización: noviembre 2007

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.

Elemento <configuration>
Elemento system.web (Esquema de configuración de ASP.NET)
Elemento profile (Esquema de configuración de ASP.NET)

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

Atributos y elementos

Las siguientes secciones describen atributos, elementos secundarios y 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. El valor predeterminado 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.

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 en cada archivo de configuración usado por Common Language Runtime y las aplicaciones .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

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

Atributos y elementos

Atributos

Elementos secundarios

Elementos primarios

Comentarios

Configuración predeterminada

Ejemplo

Información de elemento

Vea también

Tareas

Conceptos

Referencia

Otros recursos

Recursos adicionales