ProfileModule ProfileModule ProfileModule ProfileModule Class

Определение

Управляет созданием профиля пользователя и событиями профиля.Manages the creation of the user profile and profile events. Этот класс не наследуется.This class cannot be inherited.

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
Наследование
ProfileModuleProfileModuleProfileModuleProfileModule
Реализации

Примеры

В следующем примере показан файл Web. config, включающий анонимную идентификацию и свойства профиля, поддерживающие анонимных пользователей.The following example shows a Web.config file that enables anonymous identification and profile properties that support anonymous users.

<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.The following code example shows the MigrateAnonymous event included in the Global.asax file for an ASP.NET application. MigrateAnonymous Событие копирует значения свойств профиля из анонимного профиля в профиль для текущего пользователя.The MigrateAnonymous event copies profile property values from the anonymous profile to the profile for the current user.

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объекта.When the user profile is enabled, ASP.NET uses the ProfileModule to create the user profile and store it in the Profile property of the current HttpContext.

ProfileModule Предоставляет следующие события, которые можно выполнять для настройки проверки подлинности в приложении:The ProfileModule exposes the following events you can handle to configure authentication in your application:

  • MigrateAnonymous Событие для переноса параметров профиля из анонимного профиля в профиль, прошедший проверку подлинности, при входе в систему анонимного пользователя.The MigrateAnonymous event, to migrate profile settings from an anonymous profile to an authenticated profile when an anonymous user logs in.

  • Personalize Событие, предназначенное для настройки способа создания профиля пользователя.The Personalize event, to customize how the user profile is created.

  • Событие для управления сохранением профиля пользователя, AutomaticSaveEnabled если свойство имеет значение true. ProfileAutoSavingThe ProfileAutoSaving event, to control how the user profile is saved when the AutomaticSaveEnabled property is set to true.

Сведения о включении профиля пользователя см. в разделе элемент Profile (схема параметров ASP.NET).For information about enabling the user profile, see profile Element (ASP.NET Settings Schema).

Конструкторы

ProfileModule() ProfileModule() ProfileModule() ProfileModule()

Инициализирует новый экземпляр класса ProfileModule.Initializes a new instance of the ProfileModule class.

Методы

Dispose() Dispose() Dispose() Dispose()

Освобождает все ресурсы, занятые модулем ProfileModule.Releases all resources used by the ProfileModule.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Inherited from Object)
Init(HttpApplication) Init(HttpApplication) Init(HttpApplication) Init(HttpApplication)

Вызывает код инициализации после создания объекта ProfileModule.Calls initialization code when a ProfileModule object is created.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Inherited from Object)

События

MigrateAnonymous MigrateAnonymous MigrateAnonymous MigrateAnonymous

Происходит, когда выполняет вход анонимный пользователь профиля.Occurs when the anonymous user for a profile logs in.

Personalize Personalize Personalize Personalize

Происходит до того, как создается профиль пользователя.Occurs before the user profile is created.

ProfileAutoSaving ProfileAutoSaving ProfileAutoSaving ProfileAutoSaving

Происходит при завершении выполнения страницы, если включено автоматическое сохранение профиля.Occurs at the end of page execution if automatic profile saving is enabled.

Применяется к

Дополнительно