ProfileModule Classe

Definizione

Spazio dei nomi:

System.Web.Profile

Assembly:

System.Web.dll

Gestisce la creazione del profilo utente e degli eventi relativi al profilo. La classe non può essere ereditata.

public ref class ProfileModule sealed : System::Web::IHttpModule

public sealed class ProfileModule : System.Web.IHttpModule

type ProfileModule = class
    interface IHttpModule

Public NotInheritable Class ProfileModule
Implements IHttpModule

Ereditarietà

Object

ProfileModule

Implementazioni

IHttpModule

Esempio

Nell'esempio seguente viene illustrato un file di Web.config che abilita le proprietà di identificazione e profilo anonime che supportano gli utenti anonimi.

<configuration>  
  <system.web>  
    <authentication mode="Forms" >  
      <forms loginUrl="login.aspx" name=".ASPXFORMSAUTH" />  
    </authentication>  

    <anonymousIdentification enabled="true" />  

    <profile enabled="true" defaultProvider="AspNetSqlProvider">  
      <properties>  
        <add name="ZipCode" allowAnonymous="true" />  
        <add name="CityAndState" allowAnonymous="true" />  
        <add name="StockSymbols" type="System.Collections.ArrayList" allowAnonymous="true" />  
      </properties>  
    </profile>  
  </system.web>  
</configuration>  

Nell'esempio di codice seguente viene illustrato l'evento MigrateAnonymous incluso nel file Global.asax per un'applicazione ASP.NET. L'evento MigrateAnonymous copia i valori delle proprietà del profilo dal profilo anonimo al profilo per l'utente corrente.

public void Profile_OnMigrateAnonymous(object sender, ProfileMigrateEventArgs args)
{
  ProfileCommon anonymousProfile = Profile.GetProfile(args.AnonymousID);

  Profile.ZipCode = anonymousProfile.ZipCode;
  Profile.CityAndState = anonymousProfile.CityAndState;
  Profile.StockSymbols = anonymousProfile.StockSymbols;

  ////////
  // Delete the anonymous profile. If the anonymous ID is not 
  // needed in the rest of the site, remove the anonymous cookie.

  ProfileManager.DeleteProfile(args.AnonymousID);
  AnonymousIdentificationModule.ClearAnonymousIdentifier(); 

  // Delete the user row that was created for the anonymous user.
  Membership.DeleteUser(args.AnonymousID, true);

}

Public Sub Profile_OnMigrateAnonymous(sender As Object, args As ProfileMigrateEventArgs)
  Dim anonymousProfile As ProfileCommon = Profile.GetProfile(args.AnonymousID)

  Profile.ZipCode = anonymousProfile.ZipCode
  Profile.CityAndState = anonymousProfile.CityAndState
  Profile.StockSymbols = anonymousProfile.StockSymbols

  ''''''''
  ' Delete the anonymous profile. If the anonymous ID is not 
  ' needed in the rest of the site, remove the anonymous cookie.

  ProfileManager.DeleteProfile(args.AnonymousID)
  AnonymousIdentificationModule.ClearAnonymousIdentifier()

  ' Delete the user row that was created for the anonymous user.
  Membership.DeleteUser(args.AnonymousID, True)
End Sub

Commenti

Quando il profilo utente è abilitato, ASP.NET usa per ProfileModule creare il profilo utente e archiviarlo nella Profile proprietà dell'oggetto corrente HttpContext.

ProfileModule espone gli eventi seguenti che è possibile gestire per configurare l'autenticazione nell'applicazione:

• Evento MigrateAnonymous , per eseguire la migrazione delle impostazioni del profilo da un profilo anonimo a un profilo autenticato quando un utente anonimo accede.

• Evento Personalize , per personalizzare la modalità di creazione del profilo utente.

• Evento ProfileAutoSaving , per controllare la modalità di salvataggio del profilo utente quando la AutomaticSaveEnabled proprietà è impostata su true.

Per informazioni sull'abilitazione del profilo utente, vedere Elemento profilo (schema delle impostazioni ASP.NET).

Costruttori

ProfileModule()

Inizializza una nuova istanza della classe ProfileModule.

Metodi

Dispose()	Rilascia tutte le risorse usate da ProfileModule.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
Init(HttpApplication)	Chiama il codice di inizializzazione quando viene creato un oggetto ProfileModule.
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Eventi

MigrateAnonymous	Viene generato quando l'utente anonimo relativo a un profilo effettua l'accesso.
Personalize	Viene generato prima della creazione di un profilo utente.
ProfileAutoSaving	Viene generato al termine dell'esecuzione della pagina se è attivato il salvataggio automatico dei profili.

Vedi anche

• Panoramica delle proprietà del profilo ASP.NET