配置文件

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

概述

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

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

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

当您创建 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