指南

配置文件

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

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

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

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

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

      IProfile defaultProfile = engine.Profiles.Default;

    

      Dim defaultProfile As IProfile = engine.Profiles.Default

    

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

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

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

    

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

    

配置文件将其数据（例如导航历史记录、代理设置、cookies、拼写检查器配置等）存储在用户数据目录内的单独目录中。

要创建隐身配置文件，应使用 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