DefaultBrowserOptionsMessageHandler Class

A message handler that sets default browser fetch options (cache, credentials, mode) for HTTP requests in Blazor WebAssembly.

public sealed class DefaultBrowserOptionsMessageHandler : DelegatingHandler

Remarks

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
DelegatingHandler DefaultBrowserOptionsMessageHandler

Constructors

NameDescription
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.cs

Initializes a new instance of the DefaultBrowserOptionsMessageHandler class.

public DefaultBrowserOptionsMessageHandler()

DefaultBrowserOptionsMessageHandler(HttpMessageHandler)

DefaultBrowserOptionsMessageHandler.cs

Initializes a new instance of the DefaultBrowserOptionsMessageHandler class with a specific inner handler.

public DefaultBrowserOptionsMessageHandler(HttpMessageHandler innerHandler)
Parameters
innerHandler HttpMessageHandler
The inner handler which is responsible for processing the HTTP response messages.

Properties

NameDescription
DefaultBrowserRequestCacheGets or sets the default cache mode for browser requests.
DefaultBrowserRequestCredentialsGets or sets the default credentials mode for browser requests.
DefaultBrowserRequestModeGets or sets the default request mode for browser requests.

DefaultBrowserRequestCache

DefaultBrowserOptionsMessageHandler.cs

Gets or sets the default cache mode for browser requests.

public BrowserRequestCache DefaultBrowserRequestCache { get; set; }

Property value

BrowserRequestCache

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.cs

Gets or sets the default credentials mode for browser requests.

public BrowserRequestCredentials DefaultBrowserRequestCredentials { get; set; }

Property value

BrowserRequestCredentials

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.

Gets or sets the default request mode for browser requests.

public BrowserRequestMode DefaultBrowserRequestMode { get; set; }

Property value

BrowserRequestMode

Remarks

When this property is not set, the mode option is not sent to the browser and the Fetch default (BrowserRequestMode.Cors) applies.