ProfileModule Classe

Référence

Définition

Espace de noms:: System.Web.Profile

Assembly:: System.Web.dll

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 des événements de profil utilisateur et 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: Object
ProfileModule

Implémente: IHttpModule

Exemples

L’exemple suivant montre un fichier Web.config qui active l’identification anonyme et les propriétés de profil 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 pour ProfileModule créer le profil utilisateur et le stocker dans la Profile propriété du actuel HttpContext.

Le ProfileModule expose les événements suivants que vous pouvez gérer pour configurer l’authentification dans votre application :

L’événement MigrateAnonymous , pour migrer les paramètres de profil d’un profil anonyme vers un profil authentifié lorsqu’un utilisateur anonyme se connecte.
L’événement Personalize , pour personnaliser la façon dont le profil utilisateur est créé.
L’événement ProfileAutoSaving , pour contrôler la façon dont le profil utilisateur est enregistré lorsque la propriété a la AutomaticSaveEnabled valeur true.

Pour plus d’informations sur l’activation du profil utilisateur, consultez Profile Element (ASP.NET Settings Schema).

Constructeurs

ProfileModule()

Initialise une nouvelle instance de la classe ProfileModule.

Méthodes

Dispose()	Libère toutes les ressources utilisées par ProfileModule.
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
Init(HttpApplication)	Appelle le code d'initialisation lorsqu'un objet ProfileModule est créé.
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

Événements

MigrateAnonymous	Se produit lorsque l'utilisateur anonyme pour 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 de profil automatique est activé.

S’applique à

Voir aussi

Vue d’ensemble des propriétés du profil ASP.NET

Partager via