ProfileModule Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Gère la création du profil utilisateur et des événements de profil. Cette classe ne peut pas être héritée.
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
- Héritage
-
ProfileModule
- Implémente
Exemples
L’exemple suivant montre un fichier Web.config qui active les propriétés d’identification et de profil anonymes qui prennent en charge les utilisateurs anonymes.
<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>
L’exemple de code suivant montre l’événement MigrateAnonymous inclus dans le fichier Global.asax pour une application ASP.NET. L’événement MigrateAnonymous copie les valeurs de propriété de profil du profil anonyme vers le profil de l’utilisateur actuel.
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
Remarques
Lorsque le profil utilisateur est activé, ASP.NET utilise le ProfileModule profil utilisateur pour créer le profil utilisateur et le stocker dans la Profile propriété du profil actuel HttpContext.
Les ProfileModule événements suivants sont exposés que vous pouvez gérer pour configurer l’authentification dans votre application :
Événement MigrateAnonymous , pour migrer les paramètres de profil d’un profil anonyme vers un profil authentifié lorsqu’un utilisateur anonyme se connecte.
Événement Personalize , pour personnaliser la façon dont le profil utilisateur est créé.
Événement ProfileAutoSaving , pour contrôler l’enregistrement du profil utilisateur lorsque la AutomaticSaveEnabled propriété est définie
truesur .
Pour plus d’informations sur l’activation du profil utilisateur, consultez l’élément de profil (schéma des paramètres ASP.NET).
Constructeurs
| Nom | Description |
|---|---|
| ProfileModule() |
Initialise une nouvelle instance de la classe ProfileModule. |
Méthodes
| Nom | Description |
|---|---|
| Dispose() |
Libère toutes les ressources utilisées par le ProfileModule. |
| Equals(Object) |
Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object) |
| GetHashCode() |
Sert de fonction de hachage par défaut. (Hérité de Object) |
| GetType() |
Obtient la Type de l’instance actuelle. (Hérité de Object) |
| Init(HttpApplication) |
Appelle le code d’initialisation lorsqu’un ProfileModule objet est créé. |
| MemberwiseClone() |
Crée une copie superficielle du Objectactuel. (Hérité de Object) |
| ToString() |
Retourne une chaîne qui représente l’objet actuel. (Hérité de Object) |
Événements
| Nom | Description |
|---|---|
| MigrateAnonymous |
Se produit lorsque l’utilisateur anonyme d’un profil se connecte. |
| Personalize |
Se produit avant la création du profil utilisateur. |
| ProfileAutoSaving |
Se produit à la fin de l’exécution de la page si l’enregistrement automatique du profil est activé. |