Introdução
Instalação
Guias
- Engine
- Perfil
- Navegador
- BrowserView
- Navegação
- Conteúdo
- Menu de contexto
- DOM
- JavaScript
- Pop-ups
- Diálogos
- Downloads
- Chrome extensions
- Rede
- Cache
- Cookies
- Proxy
- Autenticação
- Permissões
- Plugins
- Impressão
- Senhas
- Perfis de dados do usuário
- Cartões de crédito
- Mídia
- Zoom
- Corretor ortográfico
- Implantação
- Chromium
Resolução de problemas
- Registro
- Exceções comuns
- A aplicação não termina
- O vídeo não é reproduzido
- Não é possível iniciar sessão na conta Google
- Os dados do usuário não são armazenados
- Esquema de cores
- Falha no início
- Início lento no Windows
- Aplicação .NET que não responde
- Encerramento inesperado do processo Chromium
- Comportamento inesperado
- Fim do suporte do Windows 7/8/8.1
Migração
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
.