IResourceRequestHandler Interface (original) (raw)

Version 118.6.80

Implement this interface to handle events related to browser requests. The methods of this class will be called on the CEF IO thread unless otherwise indicated.

Namespace: CefSharp
Assembly: CefSharp (in CefSharp.dll) Version: 118.6.80.0 (118.6.80.0)

Syntax

public interface IResourceRequestHandler : IDisposable

public interface class IResourceRequestHandler : IDisposable

The IResourceRequestHandler type exposes the following members.

Methods

| | Name | Description | | | -------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Public method | Dispose | Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. (Inherited from IDisposable.) | | Public method | GetCookieAccessFilter | Called on the CEF IO thread before a resource request is loaded. To optionally filter cookies for the request return a ICookieAccessFilter object. | | Public method | GetResourceHandler | Called on the CEF IO thread before a resource is loaded. To specify a handler for the resource return a IResourceHandler object | | Public method | GetResourceResponseFilter | Called on the CEF IO thread to optionally filter resource response content. | | Public method | OnBeforeResourceLoad | Called on the CEF IO thread before a resource request is loaded. To redirect or change the resource load optionally modify request. Modification of the request URL will be treated as a redirect | | Public method | OnProtocolExecution | Called on the CEF UI thread to handle requests for URLs with an unknown protocol component. SECURITY WARNING: YOU SHOULD USE THIS METHOD TO ENFORCE RESTRICTIONS BASED ON SCHEME, HOST OR OTHER URL ANALYSIS BEFORE ALLOWING OS EXECUTION. | | Public method | OnResourceLoadComplete | Called on the CEF IO thread when a resource load has completed. This method will be called for all requests, including requests that are aborted due to CEF shutdown or destruction of the associated browser. In cases where the associated browser is destroyed this callback may arrive after the OnBeforeClose(IWebBrowser, IBrowser) callback for that browser. TheIsValid method can be used to test for this situation, and care should be taken not to call browser or frame methods that modify state (like LoadURL, SendProcessMessage, etc.) if the frame is invalid. | | Public method | OnResourceRedirect | Called on the CEF IO thread when a resource load is redirected. The request parameter will contain the old URL and other request-related information. The response parameter will contain the response that resulted in the redirect. The newUrl parameter will contain the new URL and can be changed if desired. | | Public method | OnResourceResponse | Called on the CEF IO thread when a resource response is received. To allow the resource load to proceed without modification return false. To redirect or retry the resource load optionally modify request and return true. Modification of the request URL will be treated as a redirect. Requests handled using the default network loader cannot be redirected in this callback. WARNING: Redirecting using this method is deprecated. Use OnBeforeResourceLoad or GetResourceHandler to perform redirects. |

Top

See Also

Reference