SchemeOptions Enumeration |
Version 101.0.180
Configuration options for registering a custom scheme.
These values are used when calling AddCustomScheme.
Namespace:
CefSharp.Enums
Assembly:
CefSharp (in CefSharp.dll) Version: 101.0.180.0 (101.0.180.0)
Syntax [FlagsAttribute]
public enum SchemeOptions
[FlagsAttribute]
public enum class SchemeOptions
Members
| Member name | Value | Description |
---|
| None | 0 |
Register scheme without options set
|
| Standard | 1 |
If Standard is set the scheme will be treated as a
standard scheme. Standard schemes are subject to URL canonicalization and
parsing rules as defined in the Common Internet Scheme Syntax RFC 1738
Section 3.1 available at http://www.ietf.org/rfc/rfc1738.txt
In particular, the syntax for standard scheme URLs must be of the form:
[scheme]://[username]:[password]@[host]:[port]/[url-path]
Standard scheme URLs must have a host component that is a fully
qualified domain name as defined in Section 3.5 of RFC 1034 [13] and
Section 2.1 of RFC 1123. These URLs will be canonicalized to
"scheme://host/path" in the simplest case and
"scheme://username:password@host:port/path" in the most explicit case. For
example, "scheme:host/path" and "scheme:///host/path" will both be
canonicalized to "scheme://host/path". The origin of a standard scheme URL
is the combination of scheme, host and port (i.e., "scheme://host:port" in
the most explicit case).
For non-standard scheme URLs only the "scheme:" component is parsed and
canonicalized. The remainder of the URL will be passed to the handler as-
is. For example, "scheme:///some%20text" will remain the same. Non-standard
scheme URLs cannot be used as a target for form submission.
|
| Local | 2 |
If Local is set the scheme will be treated with the same
security rules as those applied to "file" URLs. Normal pages cannot link to
or access local URLs. Also, by default, local URLs can only perform
XMLHttpRequest calls to the same URL (origin + path) that originated the
request. To allow XMLHttpRequest calls from a local URL to other URLs with
the same origin set the CefSettings.FileAccessFromFileUrlsAllowed
value to true. To allow XMLHttpRequest calls from a local URL to all
origins set the CefSettings.UniversalAccessFromFileUrlsAllowed value
to true.
|
| DisplayIsolated | 4 |
If DisplayIsolated is set the scheme can only be
displayed from other content hosted with the same scheme. For example,
pages in other origins cannot create iframes or hyperlinks to URLs with the
scheme. For schemes that must be accessible from other schemes don't set
this, set CorsEnabled, and use CORS "Access-Control-Allow-Origin" headers
to further restrict access.
|
| Secure | 8 |
If Secure is set the scheme will be treated with the same
security rules as those applied to "https" URLs. For example, loading this
scheme from other secure schemes will not trigger mixed content warnings.
|
| CorsEnabled | 16 |
If CorsEnabled is set the scheme can be sent CORS requests.
This value should be set in most cases where Standard is set.
|
| CspBypassing | 32 |
If CspBypassing is set the scheme can bypass Content-Security-Policy (CSP) checks.
This value should not be set in most cases where Standard is set.
|
| FetchEnabled | 64 |
If FetchEnabled is set the scheme can perform Fetch API requests.
|
See Also