Eigenverft.WebLib.Infrastructure
  • Guides
  • API
Show / Hide Table of Contents
  • Eigenverft.WebLib.Infrastructure.Hosting
    • HttpResponseExtensions
  • Eigenverft.WebLib.Infrastructure.Hosting.Configuration.Values
    • AspNetDataProtectionConfigurationValueCodecs
  • Eigenverft.WebLib.Infrastructure.Hosting.DirectoryLayout
    • WebApplicationBuilderFactory
  • Eigenverft.WebLib.Infrastructure.Hosting.Features
    • HttpContextFeatureExtensions
  • Eigenverft.WebLib.Infrastructure.Hosting.Hsts
    • WebLibHstsExtensions
  • Eigenverft.WebLib.Infrastructure.Hosting.Kestrel
    • ConfigureWebHostBuilderExtensions
  • Eigenverft.WebLib.Infrastructure.Hosting.Middleware.CanonicalHostRedirect
    • CanonicalHostMode
    • CanonicalHostRedirectExtensions
    • CanonicalHostRedirectOptions
  • Eigenverft.WebLib.Infrastructure.Hosting.Middleware.ClientNetwork
    • ClientForwardedIpAddress
    • ClientForwardedIpSource
    • ClientNetworkApplicationBuilderExtensions
    • ClientNetworkMiddleware
    • IClientNetworkFeature
  • Eigenverft.WebLib.Infrastructure.Hosting.Middleware.HealthProbeFaviconAware
    • HealthProbeFaviconAwareExtensions
  • Eigenverft.WebLib.Infrastructure.Hosting.Middleware.Infrastructure
    • ApplicationBuilderMiddlewareExtensions
    • ServiceProviderRegistrationExtensions
  • Eigenverft.WebLib.Infrastructure.Hosting.Pipeline
    • PipelinePartitioningExtensions
  • Eigenverft.WebLib.Infrastructure.Hosting.RateLimiting
    • MissingClientIpBehavior
    • WebLibRequestTrafficShapingOptions
    • WebLibRequestTrafficShapingPerClientOptions
    • WebLibRequestTrafficShapingServerWideOptions
    • WebLibRequestTrafficShapingServiceCollectionExtensions
  • Eigenverft.WebLib.Infrastructure.Hosting.RequestTrafficLogging
    • RequestTrafficLoggingApplicationBuilderExtensions
    • RequestTrafficLoggingFields
    • RequestTrafficLoggingOptions
    • RequestTrafficLoggingServiceCollectionExtensions
    • SensitiveValueMode
  • Eigenverft.WebLib.Infrastructure.Hosting.SelfHttpWarmup
    • SelfHttpWarmupOptions
    • SelfHttpWarmupServiceCollectionExtensions
  • Eigenverft.WebLib.Infrastructure.Hosting.StaticFiles
    • AdditionalMappings
    • StaticFileAdditionalMappings
    • StaticFileApplicationBuilderExtensions
  • Eigenverft.WebLib.Infrastructure.Transformations
    • AspNetDataProtectionStringTransforms

Class CanonicalHostRedirectExtensions

Registers and activates canonical host redirect behavior.

Inheritance
object
CanonicalHostRedirectExtensions
Inherited Members
object.Equals(object)
object.Equals(object, object)
object.GetHashCode()
object.GetType()
object.MemberwiseClone()
object.ReferenceEquals(object, object)
object.ToString()
Namespace: Eigenverft.WebLib.Infrastructure.Hosting.Middleware.CanonicalHostRedirect
Assembly: Eigenverft.WebLib.Infrastructure.dll
Syntax
public static class CanonicalHostRedirectExtensions

Methods

| Edit this page View Source

AddCanonicalHostRedirect(IServiceCollection)

Registers canonical host redirect options from the standard CanonicalHostRedirect configuration section.

Declaration
public static IServiceCollection AddCanonicalHostRedirect(this IServiceCollection services)
Parameters
Type Name Description
IServiceCollection services

The service collection.

Returns
Type Description
IServiceCollection

The same service collection.

| Edit this page View Source

AddCanonicalHostRedirect(IServiceCollection, Action<CanonicalHostRedirectOptions>)

Registers canonical host redirect options and applies code-based configuration after configuration binding.

Declaration
public static IServiceCollection AddCanonicalHostRedirect(this IServiceCollection services, Action<CanonicalHostRedirectOptions> configure)
Parameters
Type Name Description
IServiceCollection services

The service collection.

Action<CanonicalHostRedirectOptions> configure

Additional options configuration.

Returns
Type Description
IServiceCollection

The same service collection.

| Edit this page View Source

UseCanonicalHostRedirect(IApplicationBuilder)

Adds the canonical host redirect middleware to the request pipeline.

Declaration
public static IApplicationBuilder UseCanonicalHostRedirect(this IApplicationBuilder app)
Parameters
Type Name Description
IApplicationBuilder app

The application builder.

Returns
Type Description
IApplicationBuilder

The same application builder.

Remarks

Place forwarded-header middleware before this call when a reverse proxy supplies the external host or scheme. The matching AddCanonicalHostRedirect() registration is required and is checked without activating services.

| Edit this page View Source

UseCanonicalHostRedirect(IApplicationBuilder, Action<CanonicalHostRedirectOptions>)

Adds the canonical host redirect middleware and overrides only the values that differ for this middleware use.

Declaration
public static IApplicationBuilder UseCanonicalHostRedirect(this IApplicationBuilder app, Action<CanonicalHostRedirectOptions> configure)
Parameters
Type Name Description
IApplicationBuilder app

The application builder.

Action<CanonicalHostRedirectOptions> configure

Values to override for this middleware use.

Returns
Type Description
IApplicationBuilder

The same application builder.

Remarks

Shared defaults still come from AddCanonicalHostRedirect(), configuration binding, and registered code configuration. This delegate is applied last for this concrete middleware use, after registered post-configuration and before validation. Other UseCanonicalHostRedirect() calls are unaffected. Configuration reloads rebuild this local variant from the updated shared options pipeline and then reapply the local override.

  • Edit this page
  • View Source
In this article
Back to top