Click or drag to resize

RequestContextSetPreference Method

Version 73.1.130
Set the value associated with preference name. If value is null the preference will be restored to its default value. If setting the preference fails then error will be populated with a detailed description of the problem. This method must be called on the CEF UI thread. Preferences set via the command-line usually cannot be modified.

Namespace:  CefSharp
Assembly:  CefSharp.Core (in CefSharp.Core.dll) Version: 73.1.130.0
Syntax
Copy
public virtual bool SetPreference(
	string name,
	Object value,
	out string error
)

Parameters

name
Type: SystemString
preference key
value
Type: SystemObject
preference value
error
Type: SystemString
out error

Return Value

Type: Boolean
Returns true if the value is set successfully and false otherwise.

Implements

IRequestContextSetPreference(String, Object, String)
Remarks
Use Cef.UIThreadTaskFactory to execute this method if required, [!:IBrowserProcessHandler.OnContextInitialized] and ChromiumWebBrowser.IsBrowserInitializedChanged are both executed on the CEF UI thread, so can be called directly. When CefSettings.MultiThreadedMessageLoop == false (the default is true) then the main application thread will be the CEF UI thread.
See Also