dotnet/wpf · error · ArgumentOutOfRangeException

SR.Format(SR.InvalidCtorParameterNoNegative, "value")

Error message

SR.Format(SR.InvalidCtorParameterNoNegative, "value")

What it means

The FigureLength constructor rejects a negative value (value < 0.0) with ArgumentOutOfRangeException. Figure lengths are non-negative quantities; Auto/Pixel/Column/Content/Page all require value >= 0.

Solutions

1. Clamp with Math.Max(0, value) before constructing the FigureLength.
2. Validate the input value before the call and reject or correct negatives at the source.
3. Fix the upstream calculation that produces a negative size.

Example fix

// before
var length = new FigureLength(available - used, FigureUnitType.Pixel); // may be negative

// after
var length = new FigureLength(Math.Max(0, available - used), FigureUnitType.Pixel);

if (value < 0.0)
    throw new ArgumentOutOfRangeException(nameof(value), "FigureLength value must be non-negative.");

bool IsNonNegative(double v) => !double.IsNaN(v) && v >= 0.0;

try { var len = new FigureLength(value, unit); }
catch (ArgumentOutOfRangeException) { /* clamp to 0 or recompute the size */ }

When it happens

Trigger: Calling new FigureLength(x, type) with x < 0.0 for any FigureUnitType — e.g. subtracting margins into a computed size.

Common situations: Computed sizes going negative after subtraction; parsing user input without validation; sign errors in layout math.

Related errors

• SR.Rect_WidthAndHeightCannotBeNegative
• Width and Height cannot be negative.
• 0x80040206
• args
• args

AI-assisted analysis of dotnet/wpf@81131a70a4 (2026-09-14). Data as JSON: /api/errors/4d5d5997a6dc64ed. Report an issue: GitHub.

Appendix: source

Thrown at src/Microsoft.DotNet.Wpf/src/PresentationFramework/System/Windows/FigureLength.cs:111

        /// or <c>value</c> parameter is <c>double.PositiveInfinity</c>.
        /// or <c>value</c> parameter is <c>negative</c>.
        /// </exception>
        public FigureLength(double value, FigureUnitType type)
        {
            double maxColumns = PTS.Restrictions.tscColumnRestriction;
            double maxPixel = Math.Min(1000000, PTS.MaxPageSize);

            if (double.IsNaN(value))
            {
                throw new ArgumentException(SR.Format(SR.InvalidCtorParameterNoNaN, "value"));
            }
            if (double.IsInfinity(value))
            {
                throw new ArgumentException(SR.Format(SR.InvalidCtorParameterNoInfinity, "value"));
            }
            if (value < 0.0)
            {
                throw new ArgumentOutOfRangeException(SR.Format(SR.InvalidCtorParameterNoNegative, "value"));
            }
            if (    type != FigureUnitType.Auto
                &&  type != FigureUnitType.Pixel
                &&  type != FigureUnitType.Column
                &&  type != FigureUnitType.Content
                &&  type != FigureUnitType.Page   )
            {
                throw new ArgumentException(SR.Format(SR.InvalidCtorParameterUnknownFigureUnitType, "type"));
            }
            if (type is FigureUnitType.Content or FigureUnitType.Page)
            {
                ArgumentOutOfRangeException.ThrowIfGreaterThan(value, 1.0);
            }

            if (type == FigureUnitType.Column)
            {
                ArgumentOutOfRangeException.ThrowIfGreaterThan(value, maxColumns);
            }

View on GitHub (pinned to 81131a70a4)