File: Constraints\OptionalRouteConstraint.cs
Web Access
Project: src\src\Http\Routing\src\Microsoft.AspNetCore.Routing.csproj (Microsoft.AspNetCore.Routing)
// Licensed to the .NET Foundation under one or more agreements.
// The .NET Foundation licenses this file to you under the MIT license.
 
#if !COMPONENTS
using Microsoft.AspNetCore.Http;
#else
using Microsoft.AspNetCore.Components.Routing;
#endif
 
namespace Microsoft.AspNetCore.Routing.Constraints;
 
#if !COMPONENTS
/// <summary>
/// Defines a constraint on an optional parameter. If the parameter is present, then it is constrained by InnerConstraint.
/// </summary>
public class OptionalRouteConstraint : IRouteConstraint
#else
internal class OptionalRouteConstraint : IRouteConstraint
#endif
{
    /// <summary>
    /// Creates a new <see cref="OptionalRouteConstraint"/> instance given the <paramref name="innerConstraint"/>.
    /// </summary>
    /// <param name="innerConstraint"></param>
    public OptionalRouteConstraint(IRouteConstraint innerConstraint)
    {
        ArgumentNullException.ThrowIfNull(innerConstraint);
 
        InnerConstraint = innerConstraint;
    }
 
    /// <summary>
    /// Gets the <see cref="IRouteConstraint"/> associated with the optional parameter.
    /// </summary>
    public IRouteConstraint InnerConstraint { get; }
 
    /// <inheritdoc />
    public bool Match(
#if !COMPONENTS
        HttpContext? httpContext,
        IRouter? route,
        string routeKey,
        RouteValueDictionary values,
        RouteDirection routeDirection)
#else
        string routeKey,
        RouteValueDictionary values)
#endif
    {
        ArgumentNullException.ThrowIfNull(routeKey);
        ArgumentNullException.ThrowIfNull(values);
 
        if (values.TryGetValue(routeKey, out _))
        {
            return InnerConstraint.Match(
#if !COMPONENTS
                httpContext,
                route,
#endif
                routeKey,
#if !COMPONENTS
                values,
                routeDirection);
#else
                values);
#endif
        }
 
        return true;
    }
}