Enum TagHelperBaseUrlMode

Namespace

Cuemon.AspNetCore.Razor.TagHelpers

Assembly

Cuemon.AspNetCore.Razor.TagHelpers.dll

Specifies how the base URL of a static resource is resolved.

public enum TagHelperBaseUrlMode

Fields

Automatic = 1

Specifies that the base URL is resolved from the configured value of BaseUrl when available; otherwise from the current HTTP request.

Configured = 0

Specifies that the base URL is resolved exclusively from the configured values of BaseUrl and Scheme.

Examples

The TagHelperBaseUrlMode enumeration controls how the base URL of a static resource is resolved by the app- and CDN-scoped tag helpers. Configured (the default) resolves the base URL exclusively from the configured BaseUrl and Scheme, whereas Automatic uses the configured BaseUrl when present and otherwise derives the base URL from the current HTTP request — useful when the same deployment is served from multiple origins. The following example demonstrates both modes through CdnTagHelperOptions and GetFormattedBaseUrl.

using System;
using Cuemon.AspNetCore.Razor.TagHelpers;
using Microsoft.AspNetCore.Http;

namespace DocfxExamples;

public class TagHelperBaseUrlModeExample
{
    public void Demonstrate()
    {
        var configured = new CdnTagHelperOptions
        {
            BaseUrlMode = TagHelperBaseUrlMode.Configured,
            Scheme = ProtocolUriScheme.Https,
            BaseUrl = "static.example.com"
        };
        Console.WriteLine(configured.GetFormattedBaseUrl()); // Output: https://static.example.com/

        var automatic = new CdnTagHelperOptions
        {
            BaseUrlMode = TagHelperBaseUrlMode.Automatic,
            BaseUrl = null // No fixed origin, so fall back to the current HTTP request.
        };
        var request = new DefaultHttpContext().Request;
        request.Scheme = "https";
        request.Host = new HostString("app.example.com");
        request.PathBase = "/myapp";
        Console.WriteLine(automatic.GetFormattedBaseUrl(request)); // Output: https://app.example.com/myapp/
    }
}