配置文件

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

概述

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

在 DotNetBrowser 中，可通过返回 IProfiles 的 IEngine.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。