Click or drag to resize
CfxRequestContextSettings Class

[This is preliminary documentation and is subject to change.]

Request context initialization settings. Specify NULL or 0 to get the recommended default values.
Inheritance Hierarchy
SystemObject
  ChromiumCfxObject
    ChromiumCfxStructure
      ChromiumCfxRequestContextSettings

Namespace: Chromium
Assembly: ChromiumFX (in ChromiumFX.dll)
Syntax
public sealed class CfxRequestContextSettings : CfxStructure

The CfxRequestContextSettings type exposes the following members.

Constructors
  NameDescription
Public methodCfxRequestContextSettings
Initializes a new instance of the CfxRequestContextSettings class
Top
Properties
  NameDescription
Public propertyAcceptLanguageList
Comma delimited ordered list of language codes without any whitespace that will be used in the "Accept-Language" HTTP header. Can be set globally using the CfxSettings.AcceptLanguageList value or overridden on a per- browser basis using the CfxBrowserSettings.AcceptLanguageList value. If all values are empty then "en-US,en" will be used. This value will be ignored if |cachePath| matches the CfxSettings.CachePath value.
Public propertyCachePath
The location where cache data will be stored on disk. If empty then browsers will be created in "incognito mode" where in-memory caches are used for storage and no data is persisted to disk. HTML5 databases such as localStorage will only persist across sessions if a cache path is specified. To share the global browser cache and related configuration set this value to match the CfxSettings.CachePath value.
Public propertyEnableNetSecurityExpiration
Set to true (1) to enable date-based expiration of built in network security information (i.e. certificate transparency logs, HSTS preloading and pinning information). Enabling this option improves network security but may cause HTTPS load failures when using CEF binaries built more than 10 weeks in the past. See https://www.certificate-transparency.org/ and https://www.chromium.org/hsts for details. Can be set globally using the CfxSettings.EnableNetSecurityExpiration value.
Public propertyIgnoreCertificateErrors
Set to true (1) to ignore errors related to invalid SSL certificates. Enabling this setting can lead to potential security vulnerabilities like "man in the middle" attacks. Applications that load content from the internet should not enable this setting. Can be set globally using the CfxSettings.IgnoreCertificateErrors value. This value will be ignored if |cachePath| matches the CfxSettings.CachePath value.
Public propertyPersistSessionCookies
To persist session cookies (cookies without an expiry date or validity interval) by default when using the global cookie manager set this value to true (1). Session cookies are generally intended to be transient and most Web browsers do not persist them. Can be set globally using the CfxSettings.PersistSessionCookies value. This value will be ignored if |cachePath| is empty or if it matches the CfxSettings.CachePath value.
Public propertyPersistUserPreferences
To persist user preferences as a JSON file in the cache path directory set this value to true (1). Can be set globally using the CfxSettings.PersistUserPreferences value. This value will be ignored if |cachePath| is empty or if it matches the CfxSettings.CachePath value.
Top
Remarks
See also the original CEF documentation in cef/include/internal/cef_types.h.
See Also