# Cordon

**Repository Path**: dotnetchina/Cordon

## Basic Information

- **Project Name**: Cordon
- **Description**: Cordon 是一个为 .NET 开发者打造的高表现力数据校验库，通过链式语法与可扩展规则引擎，为数据流动设置精准的“警戒线”。无论是验证 API 输入、表单提交，还是清洗异构数据流，Cordon 都能以极简代码实现企业级校验强度。
- **Primary Language**: C#
- **License**: MIT
- **Default Branch**: master
- **Homepage**: https://furion.net/docs/cordon
- **GVP Project**: No

## Statistics

- **Stars**: 9
- **Forks**: 2
- **Created**: 2025-02-15
- **Last Updated**: 2026-03-19

## Categories & Tags

**Categories**: utils

**Tags**: validation, validator, Fluent, DataValidation, rule

## README

# Cordon

[![license](https://img.shields.io/badge/license-MIT-orange?cacheSeconds=10800)](https://gitee.com/dotnetchina/Cordon/blob/master/LICENSE) [![nuget](https://img.shields.io/nuget/v/Cordon.svg?cacheSeconds=10800)](https://www.nuget.org/packages/Cordon) [![dotNET China](https://img.shields.io/badge/organization-dotNET%20China-yellow?cacheSeconds=10800)](https://gitee.com/dotnetchina)

Cordon is a highly expressive data validation library built for .NET developers. With its fluent syntax and extensible
rule engine, it establishes precise "guardrails" for data flows. Whether validating API inputs, form submissions, or
cleansing heterogeneous data streams, Cordon enables enterprise-grade validation with minimal code.

## Features

- **Non-intrusive Integration**: No configuration required—integrate directly into existing projects.
- **Fluent Validation Syntax**: Chainable, declarative APIs that make validation logic clear and readable.
- **Comprehensive Coverage**: Full validation support for fields, objects, nested structures, and collections.
- **Scenario-based Rule Activation**: Dynamically compose validation logic based on business requirements.
- **Multilingual Support**: Built-in internationalization with error messages available in multiple languages.
- **Highly Customizable**: Define custom validation logic and validation attributes to fit any business rule.
- **Dependency Injection Friendly**: Register directly into the .NET service container.
- **Asynchronous Validation Support**: Validation logic can be executed asynchronously; both sync and async scenarios
  are fully supported.
- **Flexible Architecture**: Designed for ease of use, extension, and maintainability.
- **Cross-platform and Dependency-free**: Runs on all major platforms with zero external dependencies.
- **High-Quality Code Assurance**: Built under strict coding standards, with 98% unit and integration test coverage.
- **.NET 8+ Compatibility**: Fully compatible with .NET 8 and later versions.

## Installation

```powershell
dotnet add package Cordon
```

## Getting Started

We have many examples on our [homepage](https://furion.net/docs/cordon/). Here's your first one to get you started:

```cs
public class User : IValidatableObject
{
    [Min(1, ErrorMessage = "{0} must not be less than 1")]
    public int Id { get; set; }

    [Required]
    public string? Name { get; set; }

    public IEnumerable<ValidationResult> Validate(ValidationContext context)
    {
        return context.With<User>()
            .RuleFor(u => u.Name).NotBlank().MinLength(3).UserName().WithMessage("{0} is not a valid internet username")
            .RuleFor(u => u.Id).Max(int.MaxValue)
            // Support rule sets (scenarios)
            .RuleSet("rule", v => 
            {
                v.RuleFor(u => u.Name).EmailAddress().WithMessage({0} is not a valid email format");
            }).ToResults();
    }
}
```

[More Documentation](https://furion.net/docs/cordon/)

## Documentation

You can find the Cordon documentation on our [homepage](https://furion.net/docs/cordon/).

## Contributing

The main purpose of this repository is to continue developing the core of Cordon, making it faster and easier to use.
The development of Cordon is publicly hosted on [Gitee](https://gitee.com/dotnetchina/Cordon), and we appreciate
community contributions for bug fixes and improvements.

## License

Cordon is released under the [MIT](./LICENSE) open source license.

[![](./assets/baiqian.svg)](https://baiqian.com)