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.
Сведения о включении профиля пользователя см. в разделе "Элемент профиля" (схема параметров ASP.NET).
Конструкторы
| Имя | Описание |
|---|---|
| ProfileModule() |
Инициализирует новый экземпляр класса ProfileModule. |
Методы
| Имя | Описание |
|---|---|
| Dispose() |
Освобождает все ресурсы, используемые параметром ProfileModule. |
| Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
| GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
| GetType() |
Возвращает Type текущего экземпляра. (Унаследовано от Object) |
| Init(HttpApplication) |
Вызывает код инициализации при ProfileModule создании объекта. |
| MemberwiseClone() |
Создает неглубокую копию текущей Object. (Унаследовано от Object) |
| ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |
События
| Имя | Описание |
|---|---|
| MigrateAnonymous |
Происходит, когда анонимный пользователь для входа в профиль. |
| Personalize |
Происходит перед созданием профиля пользователя. |
| ProfileAutoSaving |
Происходит в конце выполнения страницы, если включена автоматическая сохранение профиля. |