ProfileModule Klasa

Definicja

Przestrzeń nazw:

System.Web.Profile

Zestaw:

System.Web.dll

Zarządza tworzeniem profilu użytkownika i zdarzeń profilu. Tej klasy nie można dziedziczyć.

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

Dziedziczenie

Object

ProfileModule

Implementuje

IHttpModule

Przykłady

W poniższym przykładzie przedstawiono plik Web.config, który umożliwia identyfikację anonimową i właściwości profilu, które obsługują anonimowych użytkowników.

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

Poniższy przykład kodu przedstawia MigrateAnonymous zdarzenie zawarte w pliku Global.asax dla aplikacji ASP.NET. Zdarzenie MigrateAnonymous kopiuje wartości właściwości profilu z profilu anonimowego do profilu bieżącego użytkownika.

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

Uwagi

Po włączeniu profilu użytkownika ASP.NET używa ProfileModule elementu , aby utworzyć profil użytkownika i zapisać go we Profile właściwości bieżącej HttpContext.

Uwidacznia ProfileModule następujące zdarzenia, które można obsłużyć w celu skonfigurowania uwierzytelniania w aplikacji:

• Zdarzenie MigrateAnonymous , aby przeprowadzić migrację ustawień profilu z profilu anonimowego do profilu uwierzytelnionego, gdy zaloguje się anonimowy użytkownik.

• Zdarzenie Personalize , aby dostosować sposób tworzenia profilu użytkownika.

• Zdarzenie ProfileAutoSaving , aby kontrolować sposób zapisywania profilu użytkownika, gdy właściwość jest ustawiona AutomaticSaveEnabled na true.

Aby uzyskać informacje na temat włączania profilu użytkownika, zobacz profile, element (ASP.NET Ustawienia Schemat).

Konstruktory

Nazwa	Opis
ProfileModule()	Inicjuje nowe wystąpienie klasy ProfileModule.

Metody

Nazwa	Opis
Dispose()	Zwalnia wszystkie zasoby używane przez program ProfileModule.
Equals(Object)	Określa, czy określony obiekt jest równy bieżącemu obiektowi. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Pobiera Type bieżącego wystąpienia. (Odziedziczone po Object)
Init(HttpApplication)	Wywołuje kod inicjowania podczas ProfileModule tworzenia obiektu.
MemberwiseClone()	Tworzy płytkią kopię bieżącego Object. (Odziedziczone po Object)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Zdarzenia

Nazwa	Opis
MigrateAnonymous	Występuje, gdy anonimowy użytkownik logowania profilu.
Personalize	Występuje przed utworzeniem profilu użytkownika.
ProfileAutoSaving	Występuje na końcu wykonywania strony, jeśli jest włączone automatyczne zapisywanie profilu.

Zobacz też

• Omówienie właściwości profilu ASP.NET