ProfileModule Klasse

Referenz

Definition

Namespace:: System.Web.Profile

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Verwaltet die Erstellung des Benutzerprofils und von Profilereignissen. Diese Klasse kann nicht vererbt werden.

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

Vererbung: Object
ProfileModule

Implementiert: IHttpModule

Beispiele

Das folgende Beispiel zeigt eine Web.config-Datei, die anonyme Identifikations- und Profileigenschaften ermöglicht, die anonyme Benutzer unterstützen.

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

Das folgende Codebeispiel zeigt das Ereignis, das MigrateAnonymous in der Datei Global.asax für eine ASP.NET Anwendung enthalten ist. Das MigrateAnonymous Ereignis kopiert Profileigenschaftenwerte aus dem anonymen Profil in das Profil für den aktuellen Benutzer.

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

Hinweise

Wenn das Benutzerprofil aktiviert ist, verwendet ASP.NET den ProfileModule , um das Benutzerprofil zu erstellen und in der Profile Eigenschaft des aktuellen HttpContextzu speichern.

Macht ProfileModule die folgenden Ereignisse verfügbar, die Sie verarbeiten können, um die Authentifizierung in Ihrer Anwendung zu konfigurieren:

Das MigrateAnonymous Ereignis, um Profileinstellungen von einem anonymen Profil zu einem authentifizierten Profil zu migrieren, wenn sich ein anonymer Benutzer anmeldet.
Das Personalize Ereignis, um die Erstellung des Benutzerprofils anzupassen.
Das ProfileAutoSaving -Ereignis, um zu steuern, wie das Benutzerprofil gespeichert wird, wenn die AutomaticSaveEnabled -Eigenschaft auf truefestgelegt ist.

Informationen zum Aktivieren des Benutzerprofils finden Sie unter profile Element (ASP.NET Settings Schema).

Konstruktoren

ProfileModule()

Initialisiert eine neue Instanz der ProfileModule-Klasse.

Methoden

Dispose()	Gibt alle vom ProfileModule verwendeten Ressourcen frei.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
Init(HttpApplication)	Ruft den Initialisierungscode auf, wenn ein ProfileModule-Objekt erstellt wird.
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Ereignisse

MigrateAnonymous	Tritt auf, wenn sich der anonyme Benutzer für ein Profil anmeldet.
Personalize	Tritt auf, bevor das Benutzerprofil erstellt wird.
ProfileAutoSaving	Tritt am Schluss der Seitenausführung auf, wenn das automatische Speichern von Profilen aktiviert ist.

Gilt für:

Weitere Informationen

Übersicht über ASP.NET Profileigenschaften

Freigeben über