Elemento profile (schema delle impostazioni ASP.NET)

Articolo
09/12/2008

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.

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

Condividi tramite

Elemento profile (schema delle impostazioni ASP.NET)

Attributi ed elementi

Attributi

Elementi figlio

Elementi padre

Note

Configurazione predefinita

Esempio

Informazioni sull'elemento

Vedere anche

Attività

Concetti

Riferimenti

Altre risorse

Risorse aggiuntive