ProfileModule Classe

  • Referência

Definição

Namespace:
System.Web.Profile
Assembly:
System.Web.dll

Gerencia a criação do perfil do usuário e dos eventos de perfil. Essa 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 a seguir mostra um arquivo Web.config que permite a identificação anônima e propriedades de perfil que dão suporte a usuários 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 a seguir mostra o MigrateAnonymous evento incluído no arquivo Global.asax para um aplicativo ASP.NET. O MigrateAnonymous evento copia valores de propriedade de perfil do perfil anônimo para o perfil do usuário 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

Comentários

Quando o perfil do usuário está habilitado, ASP.NET usa o ProfileModule para criar o perfil do usuário e armazená-lo na Profile propriedade do atual HttpContext.

O ProfileModule expõe os seguintes eventos que você pode manipular para configurar a autenticação em seu aplicativo:

  • O MigrateAnonymous evento, para migrar as configurações de perfil de um perfil anônimo para um perfil autenticado quando um usuário anônimo fizer logon.

  • O Personalize evento , para personalizar como o perfil do usuário é criado.

  • O ProfileAutoSaving evento , para controlar como o perfil do usuário é salvo quando a AutomaticSaveEnabled propriedade é definida truecomo .

Para obter informações sobre como habilitar o perfil de usuário, consulte Elemento de perfil (esquema de configurações ASP.NET).

Construtores

ProfileModule()

Inicializa uma nova instância da classe ProfileModule.

Métodos

Dispose()

Libera todos os recursos usados pelo ProfileModule.
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como a função de hash padrão.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
Init(HttpApplication)

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

Cria uma cópia superficial do Object atual.

(Herdado de Object)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)

Eventos

MigrateAnonymous

Ocorre quando o usuário anônimo de um perfil faz logon.
Personalize

Ocorre antes da criação do perfil do usuário.
ProfileAutoSaving

Ocorre no final da execução da página se o salvamento de perfil automático está habilitado.

Aplica-se a

Confira também