List icon Conteúdo

Perfil

Este guia descreve como gerir os perfis do Chromium.

Visão geral

O perfil armazena os dados do usuário, como o histórico de navegação, os cookies, o cache, as senhas, etc.

No DotNetBrowser, a funcionalidade relacionada com o perfil pode ser acessada através da propriedade IEngine.Profiles que devolve IProfiles. Esta interface permite gerir perfis.

Cada perfil é representado por uma instância separada IProfile. Utilizando esta instância, você pode obter todas as informações necessárias sobre o perfil, como o seu nome, o caminho absoluto para a pasta onde o perfil armazena os seus dados e fornece acesso aos serviços relacionados com o perfil:

  • Níveis de zoom
  • Plugins
  • Proxy
  • Rede
  • Corretor ortográfico
  • Armazenamento de cookies
  • HttpCache
  • Downloads
  • Permissões

Perfil padrão

Quando você cria uma instância do IEngine, o perfil predefinido é sempre inicializado. Você pode obtê-lo utilizando a propriedade IProfiles.Default:

IProfile defaultProfile = engine.Profiles.Default;
Dim defaultProfile As IProfile = engine.Profiles.Default

Incógnito

Para tornar o perfil padrão incógnito, utilize a opção Incógnito ao criar uma instância do Engine. Esta opção afeta apenas o perfil padrão.

Criando um perfil

Para criar um novo perfil, utilize o método IProfiles.Create().

IProfile profile = engine.Profiles.Create("Test");
Dim profile As IProfile = engine.Profiles.Create("Test")

O perfil armazena os seus dados, como o histórico de navegação, as definições de proxy, os cookies, as configurações do corretor ortográfico, etc., numa pasta separada dentro da pasta de dados do usuário.

Criar um perfil incógnito

Para criar um perfil incógnito, você deve ser utilizado o parâmetro ProfileType.Incognito.

IProfile newIncognitoProfile = engine.Profiles.Create("Test", ProfileType.Incognito);
Dim newIncognitoProfile As IProfile = engine.Profiles.Create("Test", ProfileType.Incognito)

Obter perfis

Para acessar todos os perfis criados no engine, utilize IProfiles como IEnumerable<IProfile>:

foreach (IProfile profile in profiles)
{
    string name = profile.Name;
}
For Each profile As IProfile In profiles
    Dim name As String = profile.Name
Next

Esta abordagem também irá iterar sobre o perfil predefinido.

Remover perfil

Para remover um perfil existente, você deve utilizar o método IProfiles.Remove(IProfile).

Quando se remove um perfil, todos os navegadores associados a ele são eliminados. Uma tentativa de utilizar uma instância de IProfile já removida dará origem à ObjectDisposedException.

O perfil padrão não pode ser removido. Uma tentativa de eliminar o perfil padrão conduz à IllegalArgumentException.

Go Top