Merge in v5.9.6

Author: jonsagara

Directory.Build.props

@@ -4,7 +4,7 @@
 		<TargetFrameworks>net10.0;net11.0</TargetFrameworks>
 
 		<!-- NuGet -->
-		<Version>6.0.0-preview5</Version>
+		<Version>6.0.0-preview6</Version>
 		<AssemblyVersion>6.0.0</AssemblyVersion>
 		<FileVersion>6.0.0</FileVersion>
 		<Authors>Jon Sagara</Authors>

src/Sagara.Core.Tests/EnumsTests/EnumTraitsTests.cs

@@ -116,6 +116,43 @@ public void IsValidValue_ReturnsFalse()
         Assert.False(EnumTraits<ValuesEnum>.IsValidValue(ValuesEnum.Unknown));
     }
 
+    [Theory]
+    [InlineData(ValuesEnum.Value1)]
+    [InlineData(ValuesEnum.Value2)]
+    [InlineData(ValuesEnum.Value3)]
+    public void EnsureValidValue_ValidValue_DoesNotThrow(ValuesEnum value)
+    {
+        EnumTraits<ValuesEnum>.EnsureValidValue(value);
+    }
+
+    [Fact]
+    public void EnsureValidValue_InvalidValue_Throws()
+    {
+        Assert.Throws<ArgumentException>(() =>
+            EnumTraits<ValuesEnum>.EnsureValidValue(ValuesEnum.Unknown)
+            );
+    }
+
+    [Fact]
+    public void EnsureValidValue_UndefinedCastValue_Throws()
+    {
+        Assert.Throws<ArgumentException>(() =>
+            EnumTraits<ValuesEnum>.EnsureValidValue((ValuesEnum)99)
+            );
+    }
+
+    [Fact]
+    public void EnsureValidValue_InvalidValue_ExceptionMessage_ContainsEnumTypeAndValue()
+    {
+        var ex = Assert.Throws<ArgumentException>(() =>
+            EnumTraits<ValuesEnum>.EnsureValidValue(ValuesEnum.Unknown)
+            );
+
+        Assert.Contains(typeof(ValuesEnum).FullName!, ex.Message, StringComparison.Ordinal);
+        Assert.Contains(nameof(ValuesEnum.Unknown), ex.Message, StringComparison.Ordinal);
+        Assert.Equal("value", ex.ParamName);
+    }
+
     [Fact]
     public void EnsureNoDuplicateValues_NoDuplicates_DoesNotThrow()
     {

src/Sagara.Core/Enums/EnumTraits.cs

@@ -108,6 +108,19 @@ public static void EnsureNoDuplicateValues()
         }
     }
 
+    /// <summary>
+    /// Throws an <see cref="ArgumentException"/> if the enum value is not in the list of valid values.
+    /// </summary>
+    /// <param name="value">The enum value to validate.</param>
+    /// <exception cref="ArgumentException">Thrown if the enum value is not in the list of valid values.</exception>
+    public static void EnsureValidValue(TEnum value)
+    {
+        if (!IsValidValue(value))
+        {
+            throw new ArgumentException($"Invalid {_enumType.FullName} enum value '{value}'.", nameof(value));
+        }
+    }
+
     /// <summary>
     /// Return the display name for the enum value, which is either from the [Display] attribute 
     /// or the property name.