Partager via


ProfileModule Classe

Définition

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

S’applique à

Voir aussi