ProfileModule Classe

Definição

Espaço de Nomes:
System.Web.Profile
Assemblagem:
System.Web.dll

Gerir a criação do perfil do utilizador e dos eventos do perfil. Esta classe não pode ser herdada.

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
Herança
Object
ProfileModule
Implementações
IHttpModule

Exemplos

O exemplo seguinte mostra um ficheiro Web.config que permite identificação anónima e propriedades de perfil que suportam utilizadores anónimos.

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

O exemplo de código seguinte mostra o evento MigrateAnonymous incluído no ficheiro Global.asax para uma aplicação ASP.NET. O MigrateAnonymous evento copia os valores das propriedades do perfil anónimo para o perfil do utilizador atual.

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

Observações

Quando o perfil de utilizador está ativado, ASP.NET usa o ProfileModule para criar o perfil de utilizador e armazená-lo na propriedade Profile do atual HttpContext.

Expõe ProfileModule os seguintes eventos que pode gerir para configurar a autenticação na sua aplicação:

  • O MigrateAnonymous evento, para migrar as definições do perfil de um perfil anónimo para um perfil autenticado quando um utilizador anónimo faz login.

  • O Personalize evento, para personalizar a forma como o perfil do utilizador é criado.

  • O ProfileAutoSaving evento, para controlar como o perfil de utilizador é guardado quando a AutomaticSaveEnabled propriedade está definida como true.

Para informações sobre como ativar o perfil de utilizador, veja profile Element (ASP.NET Settings Schema).

Construtores

Name Description
ProfileModule()

Inicializa uma nova instância da ProfileModule classe.

Métodos

Name Description
Dispose()

Liberta todos os recursos utilizados pelo ProfileModule.
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
Init(HttpApplication)

Chama código de inicialização quando um ProfileModule objeto é criado.
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)

evento

Name Description
MigrateAnonymous

Ocorre quando o utilizador anónimo de um perfil faz login.
Personalize

Ocorre antes de o perfil do utilizador ser criado.
ProfileAutoSaving

Ocorre no final da execução da página se a gravação automática do perfil estiver ativada.

Aplica-se a

Ver também