ProfileModule Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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
true
en .
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. |