SharpSanitizer

SharpSanitizer is a lightweight and flexible .NET library designed to sanitize and validate object properties through a configurable set of rules and constraints. It helps ensure data consistency, safety, and quality before persisting or processing objects.

Features

• Strongly-typed, generic sanitizer with minimal boilerplate.
• Built-in constraints for strings, numbers, collections, and objects.
• Configurable via Dictionary<string, Constraint> for maximum flexibility.
• Works with both strict and relaxed validation modes.
• Support for advanced numeric rounding and collection-level checks.

How it works

SharpSanitizer inspects the properties of an object and applies the configured constraints for each property. The sanitization process modifies values in place based on the rules you define.

Usage Example

To use the SharpSanitizer library, first populate the set of rules to be applied to the object properties. Rules are expressed through a Dictionary in which the key matches the name of the property and the value is the constraint to be applied, for example:

var constraints = new Dictionary<string, Constraint>()
{
    { "StringMaxNotNull", new Constraint(ConstraintType.MaxNotNull, 10) },
    { "StringMax", new Constraint(ConstraintType.Max, 10) },
    { "StringNoWhiteSpace", new Constraint(ConstraintType.NoWhiteSpace) },
    { "StringNoSpecialCharacters", new Constraint(ConstraintType.NoSpecialCharacters) }
};

as a second step create an instance of the SharpSanitizer specifying the type of object to work on:

var sharpSanitizer = new SharpSanitizer<FooModel>(constraints);

at this point it is enough to invoke the method Sanitize to apply the rules to the object:

sharpSanitizer.Sanitize(fooModel);

Supported Constraints

SharpSanitizer now supports a rich set of rules for validation and sanitization:

Constraint	Description
NotNull	Ensures object is not null; initializes if needed.
NoDbNull	Converts DBNull.Value to null.
NotNullOrEmpty	Ensures string is not null or empty.
NotNullOrWhiteSpace	Ensures string is not null or whitespace.
MaxLength	Truncates string to a maximum length.
MinLength	Pads string if shorter than required.
MaxNotNull	Non-null string limited to a maximum length.
Uppercase	Converts string to uppercase.
Lowercase	Converts string to lowercase.
NoWhiteSpace	Removes all whitespace.
NoSpecialCharacters	Removes all non-alphanumeric characters except _ and ..
OnlyDigit	Keeps only digits in the string.
ValidDatetime	Keeps valid date strings, clears invalid.
ForceToValidDatetime	Forces invalid dates to DateTime.MinValue.
SingleChar	Enforces single character.
ValidGuid	Enforces a valid GUID (generates new if invalid in relaxed mode).
ValidEmail	Enforces a valid email format.
MaxValue	Numeric: clamps to max value.
MinValue	Numeric: clamps to min value.
NotNegative	Numeric: clamps negatives to zero.
Positive	Enforces value ≥ 0.
StrictPositive	Enforces value > 0.
NonZero	Disallows zero, adjusts based on severity mode.
MaxDecimalPlaces	Truncates decimals to a maximum number of digits.
RoundTo	Rounds decimals to a specified number of digits.
NotEmptyCollection	Collection: must not be empty.
DistinctCollection	Collection: removes duplicates.

NuGet

The library is available on NuGet.

Contributing

Thank you for considering to help out with the source code! If you'd like to contribute, please fork, fix, commit and send a pull request for the maintainers to review and merge into the main code base.

• Setting up Git
• Fork the repository
• Open an issue if you encounter a bug or have a suggestion for improvements/features

License

SharpSanitizer source code is available under MIT License, see license in the source.

Contact

Please contact at francesco.delre.87[at]gmail.com for any details.