DefaultBrowserOptionsMessageHandler Class
A message handler that sets default browser fetch options (cache, credentials, mode) for HTTP requests in Blazor WebAssembly.
public sealed class DefaultBrowserOptionsMessageHandler : DelegatingHandlerRemarks
Only the options explicitly set on this handler are applied. An option that is left unset is not sent to the browser, so the Fetch defaults keep applying. Options already set on the request are never overridden.
See also
- Inheritance
DelegatingHandlerDefaultBrowserOptionsMessageHandler
Constructors
| Name | Description |
|---|---|
| DefaultBrowserOptionsMessageHandler() | Initializes a new instance of the DefaultBrowserOptionsMessageHandler class. |
| DefaultBrowserOptionsMessageHandler(HttpMessageHandler) | Initializes a new instance of the DefaultBrowserOptionsMessageHandler class with a specific inner handler. |
DefaultBrowserOptionsMessageHandler overloads
DefaultBrowserOptionsMessageHandler()
DefaultBrowserOptionsMessageHandler.csInitializes a new instance of the DefaultBrowserOptionsMessageHandler class.
public DefaultBrowserOptionsMessageHandler()DefaultBrowserOptionsMessageHandler(HttpMessageHandler)
DefaultBrowserOptionsMessageHandler.csInitializes a new instance of the DefaultBrowserOptionsMessageHandler class with a specific inner handler.
public DefaultBrowserOptionsMessageHandler(HttpMessageHandler innerHandler)Parameters
innerHandlerHttpMessageHandler- The inner handler which is responsible for processing the HTTP response messages.
Properties
| Name | Description |
|---|---|
| DefaultBrowserRequestCache | Gets or sets the default cache mode for browser requests. |
| DefaultBrowserRequestCredentials | Gets or sets the default credentials mode for browser requests. |
| DefaultBrowserRequestMode | Gets or sets the default request mode for browser requests. |
DefaultBrowserRequestCache
DefaultBrowserOptionsMessageHandler.csGets or sets the default cache mode for browser requests.
public BrowserRequestCache DefaultBrowserRequestCache { get; set; }Property value
Remarks
When this property is not set, the cache option is not sent to the browser and the Fetch default (BrowserRequestCache.Default) applies.
DefaultBrowserRequestCredentials
DefaultBrowserOptionsMessageHandler.csGets or sets the default credentials mode for browser requests.
public BrowserRequestCredentials DefaultBrowserRequestCredentials { get; set; }Property value
Remarks
When this property is not set, the credentials option is not sent to the browser and the Fetch default (BrowserRequestCredentials.SameOrigin) applies.
BrowserRequestCredentials.Include applies to every request sent through this handler, including cross-origin ones. Only use it on an HttpClient dedicated to a single trusted origin.
DefaultBrowserRequestMode
DefaultBrowserOptionsMessageHandler.csGets or sets the default request mode for browser requests.
public BrowserRequestMode DefaultBrowserRequestMode { get; set; }Property value
Remarks
When this property is not set, the mode option is not sent to the browser and the Fetch default (BrowserRequestMode.Cors) applies.