ProfileModule Clase

Definición

Administra la creación del perfil de usuario y los eventos del perfil. Esta clase no puede heredarse.

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
Herencia
ProfileModule
Implementaciones

Ejemplos

En el ejemplo siguiente se muestra un archivo Web.config que permite la identificación anónima y las propiedades de perfil que admiten usuarios anónimos.

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

En el ejemplo de código siguiente se muestra el MigrateAnonymous evento incluido en el archivo Global.asax para una aplicación de ASP.NET. El MigrateAnonymous evento copia los valores de propiedad de perfil del perfil anónimo en el perfil del usuario actual.

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

Comentarios

Cuando el perfil de usuario está habilitado, ASP.NET usa ProfileModule para crear el perfil de usuario y almacenarlo en la Profile propiedad del actual HttpContext.

ProfileModule Expone los siguientes eventos que puede controlar para configurar la autenticación en la aplicación:

  • Evento MigrateAnonymous , para migrar la configuración de perfil de un perfil anónimo a un perfil autenticado cuando un usuario anónimo inicia sesión.

  • Evento Personalize para personalizar cómo se crea el perfil de usuario.

  • Evento ProfileAutoSaving , para controlar cómo se guarda el perfil de usuario cuando la AutomaticSaveEnabled propiedad está establecida trueen .

Para obtener información sobre cómo habilitar el perfil de usuario, vea Profile Element (ASP.NET Settings Schema)).

Constructores

ProfileModule()

Inicializa una nueva instancia de la clase ProfileModule.

Métodos

Dispose()

Libera todos los recursos que usa ProfileModule.

Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.

(Heredado de Object)
GetHashCode()

Sirve como la función hash predeterminada.

(Heredado de Object)
GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
Init(HttpApplication)

Llama al código de inicialización cuando se crea un objeto ProfileModule.

MemberwiseClone()

Crea una copia superficial del Object actual.

(Heredado de Object)
ToString()

Devuelve una cadena que representa el objeto actual.

(Heredado de Object)

Eventos

MigrateAnonymous

Se produce cuando el usuario anónimo para un perfil inicia sesión.

Personalize

Se produce antes de que se cree el perfil de usuario.

ProfileAutoSaving

Tiene lugar al final de la ejecución de la página si la operación de almacenamiento automático del perfil está habilitada.

Se aplica a

Consulte también