Click or drag to resize

RequestContextExtensionsSetPreferenceAsync Method

Version 89.0.170
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 (in CefSharp.dll) Version: (
public static Task<SetPreferenceResponse> SetPreferenceAsync(
	this IRequestContext requestContext,
	string name,
	Object value


Type: CefSharpIRequestContext

[Missing <param name="requestContext"/> documentation for "M:CefSharp.RequestContextExtensions.SetPreferenceAsync(CefSharp.IRequestContext,System.String,System.Object)"]

Type: SystemString
preference key
Type: SystemObject
preference value

Return Value

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

Usage Note

In Visual Basic and C#, you can call this method as an instance method on any object of type IRequestContext. When you use instance method syntax to call this method, omit the first parameter. For more information, see Extension Methods (Visual Basic) or Extension Methods (C# Programming Guide).
Use Cef.UIThreadTaskFactory to execute this method if required, 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