ProfileModule Classe

  • Riferimento

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.

Si applica a

Vedi anche