Condividi tramite


Elemento profile (schema delle impostazioni ASP.NET)

Aggiornamento: novembre 2007

Configura i parametri per la gestione dei valori di profilo utente mediante il profilo ASP.NET.

Questo elemento è nuovo in .NET Framework versione 2.0.

Elemento <Configuration>
  Elemento system.web (schema delle impostazioni ASP.NET)
    Elemento profile (schema delle impostazioni ASP.NET)

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

Attributi ed elementi

Nelle sezioni riportate di seguito vengono illustrati attributi, elementi figlio ed elementi padre.

Attributi

Attributo

Descrizione

enabled

Attributo Boolean facoltativo.

Specifica se i profili utente ASP.NET sono attivati. Se l'impostazione è true, i profili utente ASP.NET sono attivati.

Il valore predefinito è true.

defaultProvider

Attributo String facoltativo.

Specifica il nome del provider di profili predefinito.

Per ulteriori informazioni, vedere Provider.

Il valore predefinito è AspNetSqlProfileProvider.

inherits

Attributo String facoltativo.

Contiene un riferimento a un tipo per un tipo personalizzato derivante dalla classe astratta ProfileBase. ASP.NET genera in modo dinamico una classe ProfileCommon che eredita da questo tipo e la inserisce nella proprietà Profile della classe HttpContext corrente.

automaticSaveEnabled

Attributo Boolean facoltativo.

Specifica se il profilo utente viene salvato automaticamente al termine dell'esecuzione di una pagina ASP.NET. Se l'impostazione è true, il profilo utente viene salvato automaticamente al termine dell'esecuzione di una pagina ASP.NET.

L'oggetto ProfileModule salva un profilo utente solo se il modulo rileva che il profilo è stato modificato, ovvero la proprietà IsDirty è true. Per ulteriori informazioni, vedere la classe Cenni preliminari sulle proprietà dei profili ASP.NET.

Il valore predefinito è true.

Elementi figlio

Elemento

Descrizione

properties

Elemento obbligatorio.

Definisce un insieme di proprietà di profilo utente e gruppi di proprietà.

providers

Elemento facoltativo.

Definisce un insieme di provider di profili.

Elementi padre

Elemento

Descrizione

configuration

Specifica l'elemento di primo livello necessario in ciascun file di configurazione utilizzato in Common Language Runtime e nelle applicazioni .NET Framework.

system.web

Specifica l'elemento di primo livello per la sezione di configurazione ASP.NET.

Note

Per informazioni su come accedere ai valori di configurazione per l'elemento profile e modificarli nel codice dell'applicazione, vedere ProfileSection.

Configurazione predefinita

Nel file Machine.config in .NET Framework versione 2.0 viene configurato l'elemento profile predefinito riportato di seguito.

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

Esempio

Nell'esempio di codice riportato di seguito viene illustrato come configurare il file Web.config per un'applicazione ASP.NET per l'utilizzo di un provider 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>

Informazioni sull'elemento

Gestore della sezione di configurazione

System.Web.Configuration.ProfileSection

Membro di configurazione

SystemWebSectionGroup.Profile

Percorsi configurabili

Machine.config

Web.config a livello di radice

Web.config a livello di applicazione

Requisiti

Microsoft Internet Information Services (IIS) versione 5.0, 5.1 o 6.0

.NET Framework versione 2.0

Microsoft Visual Studio 2005

Vedere anche

Attività

Procedura: bloccare le impostazioni di configurazione di ASP.NET

Concetti

Cenni preliminari sulle proprietà dei profili ASP.NET

Cenni preliminari sulla configurazione di ASP.NET

Controlli server Web ASP.NET e funzionalità del browser

Protezione della configurazione di ASP.NET

Scenari di configurazione ASP.NET

Riferimenti

Elemento system.web (schema delle impostazioni ASP.NET)

Elemento <Configuration>

Elemento properties per profile (schema delle impostazioni ASP.NET)

Elemento providers per profile (schema delle impostazioni ASP.NET)

ProfileSection

System.Configuration

System.Web.Configuration

Altre risorse

File di configurazione ASP.NET

Impostazioni di configurazione di ASP.NET

Impostazioni di configurazione generali (ASP.NET)

API di configurazione di ASP.NET