perfil Element (ASP.NET Settings Schema)

[Esta documentação destina-se apenas à visualização e está sujeita a alterações em versões posteriores. Os tópicos em branco estão incluídos como espaços reservados.]

Configura parâmetros para gerenciar os valores de perfil de usuário usando o ASP.Perfil de rede.

Esse elemento é novo no .NET Framework versão 2.0.

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

Attributes and Elements

As seções a seguir descrevem atributos, elementos filho, e elementos pai.

Attributes

Atributo	Descrição
enabled	Opcional Boolean atributo. Especifica se ASP.Perfis de usuário de rede são ativados. If true, ASP.Perfis de usuário de rede são ativados. O padrão é true.
defaultProvider	Opcional String atributo. Especifica o nome do provedor de perfil padrão. Para obter mais informações, consulte Provider. O padrão é AspNetSqlProfileProvider.
inherits	Opcional String atributo. Contém uma referência de tipo para um tipo personalizado que deriva do ProfileBase classe abstrata. ASP.NET gera dinamicamente um ProfileCommon classe que herda a partir desse tipo e o coloca na Profile a propriedade do atual HttpContext.
automaticSaveEnabled	Opcional Boolean atributo. Especifica se o perfil de usuário é automaticamente salvo no final da execução de um aplicativo ASP.NET personalizada. Se true, o perfil de usuário é automaticamente salvo no final da execução de um aplicativo ASP.NET personalizada. O ProfileModule objeto salva um perfil de usuário somente se o módulo detectar que o perfil foi modificado. Ou seja, o IsDirty propriedade é true. Para obter mais informações, consulte ASP.NET Profile Properties Overview. O padrão é true.

Child Elements

Elemento	Descrição
properties	Elemento necessário. Define uma coleção de propriedades de perfil de usuário e grupos de propriedades.
providers	Elemento opcional. Define uma coleção de provedores de perfil.

Parent Elements

Elemento	Descrição
configuration	Especifica o elemento raiz necessários em cada arquivo de configuração que é usado pelo common language runtime e o.Aplicativos do NET Framework.
system.web	Especifica o elemento raiz para o ASP.Seção de configuração de rede.

Remarks

Para obter informações sobre como acessar e modificar valores de configuração para o profile elemento no código do aplicativo, consulte ProfileSection.

Configuração padrão

O seguinte padrão profile elemento é configurado no arquivo Machine. config na.NET Framework versão 2.0.

<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>

Exemplo

O exemplo de código a seguir mostra como configurar o arquivo Web. config para um aplicativo ASP.NET para usar um SqlProfileProvider provedor.

<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>

Element Information

Manipulador da seção de configuração	System.Web.Configuration.ProfileSection
Membro de configuração	SystemWebSectionGroup.Profile
Locais configuráveis	Machine.config Web. config de nível de raiz Web. config de nível de aplicativo
Requisitos	Serviços de Informações da Internet da Microsoft (IIS) versão 5.0, 5.1 ou 6.0 A.NET Framework versão 2.0 Microsoft Visual Studio 2005

Consulte também

Tasks

How to: Lock ASP.NET Configuration Settings

Reference

System. Web Element (ASP.NET Settings Schema)

<configuration> Elemento

Propriedades de elemento de perfil (ASP.NET Settings Schema)

provedores de elemento para perfil (ASP.NET Settings Schema)

ProfileSection

System.Configuration

System.Web.Configuration

Concepts

ASP.NET Profile Properties Overview

ASP.NET Configuration Overview

ASP.NET Server Controls and Browser Capabilities

Securing Configuration

Configuration Inheritance

Other Resources

ASP.NET Configuration Files

ASP.Definições de configuração de rede

Configurações gerais (ASP.NET)

ASP.NET Configuration API