ProfileModule Osztály

Definíció

Névtér:
System.Web.Profile
Szerelvény:
System.Web.dll

Kezeli a felhasználói profil és a profilesemények létrehozását. Ez az osztály nem örökölhető.

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
Öröklődés
Object
ProfileModule
Megvalósítás
IHttpModule

Példák

Az alábbi példa egy Web.config fájlt mutat be, amely lehetővé teszi a névtelen felhasználókat támogató névtelen azonosítást és profiltulajdonságokat.

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

Az alábbi példakód egy ASP.NET-alkalmazás Global.asax fájljában található MigrateAnonymous eseményt mutatja be. Az MigrateAnonymous esemény a profiltulajdonság-értékeket a névtelen profilból az aktuális felhasználó profiljába másolja.

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

Megjegyzések

Ha a felhasználói profil engedélyezve van, ASP.NET a ProfileModule használatával hozza létre a felhasználói profilt, és az aktuális ProfileHttpContext tulajdonságában tárolja.

A ProfileModule következő eseményeket teszi elérhetővé az alkalmazás hitelesítésének konfigurálásához:

  • Az MigrateAnonymous esemény, a profilbeállítások névtelen profilból hitelesített profilba való migrálásához, amikor egy névtelen felhasználó bejelentkezik.

  • Az Personalize esemény a felhasználói profil létrehozásának testreszabásához.

  • Az ProfileAutoSaving esemény, amely azt szabályozza, hogy a felhasználói profil hogyan legyen mentve a AutomaticSaveEnabled tulajdonság beállításakor true.

A felhasználói profil engedélyezésével kapcsolatos információkért lásd: profilelem (ASP.NET Beállításséma).

Konstruktorok

Name Description
ProfileModule()

Inicializálja a ProfileModule osztály új példányát.

Metódusok

Name Description
Dispose()

Felszabadítja a .-hez használt összes erőforrást ProfileModule.
Equals(Object)

Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal.

(Öröklődés forrása Object)
GetHashCode()

Ez az alapértelmezett kivonatoló függvény.

(Öröklődés forrása Object)
GetType()

Lekéri az Type aktuális példányt.

(Öröklődés forrása Object)
Init(HttpApplication)

Inicializálási kódot hív meg egy ProfileModule objektum létrehozásakor.
MemberwiseClone()

Az aktuális Objectpéldány sekély másolatát hozza létre.

(Öröklődés forrása Object)
ToString()

Az aktuális objektumot jelképező sztringet ad vissza.

(Öröklődés forrása Object)

esemény

Name Description
MigrateAnonymous

Akkor fordul elő, ha egy profil névtelen felhasználója bejelentkezik.
Personalize

A felhasználói profil létrehozása előtt történik.
ProfileAutoSaving

Az oldalvégrehajtás végén történik, ha engedélyezve van az automatikus profilmentés.

A következőre érvényes:

Lásd még