The XXX enumeration type is not registered for the parse operation. Use the EnumProcessingHelper.RegisterEnum method to register the type.

• Jul 06, 2025

DevExpress components can incorrectly serialize custom enumeration values in criteria operators.

Error Description:

For columns bound to enumeration types, the grid displays a combo box editor in the filter row. When a filter is applied, the grid creates a criteria operator that contains the enumeration value reference. When the grid’s layout is saved, the component attempts to serialize this criteria operator.

For security reasons, unknown types cannot be serialized. If a column is bound to a custom enumeration type, the grid throws the following exception: The XXX enumeration type is not registered for the parse operation. Use the EnumProcessingHelper.RegisterEnum method to register the type.

Solution:

To resolve this issue, call the RegisterEnum method to register your enumeration type for the serialization/deserialization operations.

• Program.cs

using DevExpress.Data.Filtering;
// ...
var builder = WebApplication.CreateBuilder(args);
// ...
EnumProcessingHelper.RegisterEnum<CustomEnum>();
var app = builder.Build();