List icon 目录

配置文件

本指南将介绍如何管理 Chromium 配置文件。

概述

配置文件存储用户数据,如导航历史、cookie、缓存、密码等。

在 DotNetBrowser 中,可通过返回 IProfilesIEngine.Profiles 属性访问与配置文件相关的功能。 该接口允许管理配置文件。

每个配置文件都由单独的 IProfile 实例表示。 使用该实例,您可以获取有关配置文件的所有必要信息,如名称、配置文件存储数据的目录的绝对路径,并提供对配置文件相关服务的访问:

  • ZoomLevels
  • Plugins
  • Proxy
  • Network
  • SpellChecker
  • CookieStore
  • HttpCache
  • Downloads
  • Permissions

默认配置文件

当您创建 IEngine 实例时,始终会初始化默认配置文件。 您可以使用 IProfiles.Default 属性获取它:

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

隐身

要使默认配置文件隐身,请在创建 Engine 实例时使用 隐身 选项。 此选项仅影响默认配置文件。

创建配置文件

要创建新的配置文件,请使用 IProfiles.Create() 方法。

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

配置文件将导航历史记录、代理设置、cookie、拼写检查程序配置等数据存储在 用户数据目录内的一个单独目录中。

创建隐身配置文件

要创建隐身配置文件,应使用 ProfileType.Incognito 参数。

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

获取配置文件

要访问在引擎中创建的所有配置文件,请使用 IProfiles 作为 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

此方法还将迭代默认配置文件。

移除配置文件

要移除现有配置文件,您应该使用 IProfiles.Remove(IProfile) 方法。

移除配置文件时,与之关联的所有浏览器都将被释放。 尝试使用已移除的 IProfile 实例将导致 ObjectDisposedException

默认配置文件无法被移除。 尝试移除默认配置文件会导致 IllegalArgumentException

Go Top