ProfileModule Classe

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 as 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 de 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 faz logon.

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

• O ProfileAutoSaving evento, para controlar como o perfil de 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 (ASP.NET Esquema de Configurações).

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.

Confira também

• Visão geral das propriedades do perfil ASP.NET