Click or drag to resize

ChromiumWebBrowser(HtmlString, IBrowserSettings, IRequestContext, Boolean, ActionIBrowser, Boolean) Constructor

Version 130.1.90
Create a new OffScreen Chromium Browser. If you use LegacyBindingEnabled = true then you must set automaticallyCreateBrowser to false and call CreateBrowser(IWindowInfo, IBrowserSettings) after the objects are registered. The underlying Chromium Embedded Framework(CEF) Browser is created asynchronouly, to subscribe to the BrowserInitialized event it is recommended that you set automaticallyCreateBrowser to false, subscribe to the event and then call CreateBrowser(IWindowInfo, IBrowserSettings) to ensure you are subscribe to the event before it's fired (Issue https://github.com/cefsharp/CefSharp/issues/3552).

Namespace: CefSharp.OffScreen
Assembly: CefSharp.OffScreen (in CefSharp.OffScreen.dll) Version: 129.0.110.0 (129.0.110.0)
Syntax
public ChromiumWebBrowser(
	HtmlString html,
	IBrowserSettings browserSettings = null,
	IRequestContext requestContext = null,
	bool automaticallyCreateBrowser = true,
	Action<IBrowser> onAfterBrowserCreated = null,
	bool useLegacyRenderHandler = true
)

Parameters

html  HtmlString
html string to be initially loaded in the browser.
browserSettings  IBrowserSettings  (Optional)
The browser settings to use. If null, the default settings are used.
requestContext  IRequestContext  (Optional)
See RequestContext for more details. Defaults to null
automaticallyCreateBrowser  Boolean  (Optional)
automatically create the underlying Browser
onAfterBrowserCreated  ActionIBrowser  (Optional)
Use as an alternative to the BrowserInitialized event. If the underlying Chromium Embedded Framework (CEF) browser is created successfully, this action is guranteed to be called after the browser created where as the BrowserInitialized event may be called before you have a chance to subscribe to the event as the CEF Browser is created async. (Issue https://github.com/cefsharp/CefSharp/issues/3552).
useLegacyRenderHandler  Boolean  (Optional)
For those using ScreenshotAsync(Boolean, PopupBlending) or ScreenshotOrNull(PopupBlending) then this must be true, for those using CaptureScreenshotAsync(NullableCaptureScreenshotFormat, NullableInt32, Viewport) this can be false. Lower memory usage when false. Defaults to true for backwards compatability.
Exceptions
ExceptionCondition
InvalidOperationExceptionCef::Initialize() failed
See Also