Click or drag to resize
Json.NET Schema

Custom JSON validation rules


Json.NET Schema lets you extend JSON Schema with your own custom validation rules using JsonValidator.

Creating custom rules

Custom validation rules are created by implementing a JsonValidator and its two abstract methods.

A simple JsonValidator for validating culture names
public class CultureFormatValidator : JsonValidator
    public override void Validate(JToken value, JsonValidatorContext context)
        if (value.Type == JTokenType.String)
            string s = value.ToString();

                // test whether the string is a known culture, e.g. en-US, fr-FR
                new CultureInfo(s);
            catch (CultureNotFoundException)
                context.RaiseError($"Text '{s}' is not a valid culture name.");

    public override bool CanValidate(JSchema schema)
        // validator will run when a schema has a format of culture
        return (schema.Format == "culture");
Using custom rules

Custom rules must be specified when loading the schema that will use them. Add custom JsonValidator instances to the Validators collection on JSchemaReaderSettings and then load the schema using Parse(String, JSchemaReaderSettings).

Once the JSchema has been loaded validate JSON as usual. Custom validation rules will be executed along-side normal JSON Schema validation.

Loading and validating a JSchema with a custom JsonValidator
string json = @"[
  'purple monkey dishwasher',

JSchemaReaderSettings settings = new JSchemaReaderSettings
    Validators = new List<JsonValidator> { new CultureFormatValidator() }

// the culture validator will be used to validate the array items
JSchema schema = JSchema.Parse(@"{
  'type': 'array',
  'items': {
    'type': 'string',
    'format': 'culture'
}", settings);

JArray cultures = JArray.Parse(json);

IList<ValidationError> errors;
bool isValid = cultures.IsValid(schema, out errors);

// false

// Text 'purple monkey dishwasher' is not a valid culture name.

// Invalid type. Expected String but got Integer.
See Also