ProfileModule Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Spravuje vytvoření profilu uživatele a událostí profilu. Tuto třídu nelze zdědit.
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
- Dědičnost
-
ProfileModule
- Implementuje
Příklady
Následující příklad ukazuje soubor Web.config, který umožňuje anonymní identifikaci a vlastnosti profilu, které podporují anonymní uživatele.
<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>
Následující příklad kódu ukazuje MigrateAnonymous událost obsaženou v souboru Global.asax pro ASP.NET aplikaci. Událost MigrateAnonymous zkopíruje hodnoty vlastností profilu z anonymního profilu do profilu aktuálního uživatele.
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
Poznámky
Pokud je profil uživatele povolený, ASP.NET použije ProfileModule k vytvoření profilu uživatele a jeho uložení ve Profile vlastnosti aktuálního HttpContext.
Zpřístupňuje ProfileModule následující události, které můžete zpracovat ke konfiguraci ověřování ve vaší aplikaci:
Událost MigrateAnonymous , pokud chcete migrovat nastavení profilu z anonymního profilu do ověřeného profilu, když se anonymní uživatel přihlásí.
Tato Personalize událost umožňuje přizpůsobit způsob vytvoření profilu uživatele.
Událost ProfileAutoSaving , chcete-li řídit, jak je profil uživatele uložen, když AutomaticSaveEnabled je vlastnost nastavena na
true.
Informace o povolení profilu uživatele naleznete v části Element profilu (ASP.NET Schéma nastavení).
Konstruktory
| Name | Description |
|---|---|
| ProfileModule() |
Inicializuje novou instanci ProfileModule třídy. |
Metody
| Name | Description |
|---|---|
| Dispose() |
Uvolní všechny prostředky používané nástrojem ProfileModule. |
| Equals(Object) |
Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object) |
| GetHashCode() |
Slouží jako výchozí funkce hash. (Zděděno od Object) |
| GetType() |
Získá Type aktuální instance. (Zděděno od Object) |
| Init(HttpApplication) |
Volá inicializační kód při vytvoření objektu ProfileModule . |
| MemberwiseClone() |
Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object) |
| ToString() |
Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object) |
Událost
| Name | Description |
|---|---|
| MigrateAnonymous |
Nastane, když se anonymní uživatel pro přihlášení profilu. |
| Personalize |
Nastane před vytvořením profilu uživatele. |
| ProfileAutoSaving |
Nastane na konci spuštění stránky, pokud je povolené automatické ukládání profilu. |