ProfileModule Класс
В этой статье
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Управляет созданием профиля пользователя и событиями профиля. Этот класс не наследуется.
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
- Наследование
-
ProfileModule
- Реализации
Примеры
В следующем примере показан файл Web.config, который включает анонимную идентификацию и свойства профиля, поддерживающие анонимных пользователей.
<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>
В следующем примере кода показано MigrateAnonymous событие, включенное в файл Global.asax для ASP.NET приложения. Событие MigrateAnonymous копирует значения свойств профиля из анонимного профиля в профиль текущего пользователя.
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
Комментарии
Если профиль пользователя включен, ASP.NET использует ProfileModule для создания профиля пользователя и сохранения его в Profile свойстве текущего HttpContextобъекта .
Предоставляет ProfileModule следующие события, которые можно обработать для настройки проверки подлинности в приложении:
Событие MigrateAnonymous для переноса параметров профиля из анонимного профиля в профиль, прошедший проверку подлинности, когда анонимный пользователь входит в систему.
Событие Personalize для настройки способа создания профиля пользователя.
Событие ProfileAutoSaving для управления сохранением профиля пользователя, если свойству AutomaticSaveEnabled присвоено значение
true
.
Сведения о включении профиля пользователя см. в разделе Profile Element (ASP.NET Settings Schema).
Конструкторы
Profile |
Инициализирует новый экземпляр класса ProfileModule. |
Методы
Dispose() |
Освобождает все ресурсы, занятые модулем ProfileModule. |
Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
Get |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
Get |
Возвращает объект Type для текущего экземпляра. (Унаследовано от Object) |
Init(Http |
Вызывает код инициализации после создания объекта ProfileModule. |
Memberwise |
Создает неполную копию текущего объекта Object. (Унаследовано от Object) |
To |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |
События
Migrate |
Происходит, когда выполняет вход анонимный пользователь профиля. |
Personalize |
Происходит до того, как создается профиль пользователя. |
Profile |
Происходит при завершении выполнения страницы, если включено автоматическое сохранение профиля. |
Применяется к
Продукт | Версии |
---|---|
.NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |