【C#】バリデーションの実践的な実装パターンと最新のベストプラクティスを解説

using System.ComponentModel.DataAnnotations;

namespace ValidationSample.Models
{
    public class UserRegistrationDto
    {
        [Required(ErrorMessage = "ユーザー名は必須項目です。")]
        [StringLength(20, MinimumLength = 3, ErrorMessage = "ユーザー名は3文字以上20文字以内で入力してください。")]
        public string Username { get; set; } = string.Empty;

        [Required(ErrorMessage = "メールアドレスは必須項目です。")]
        [EmailAddress(ErrorMessage = "有効なメールアドレス形式で入力してください。")]
        public string Email { get; set; } = string.Empty;

        [Required(ErrorMessage = "パスワードは必須項目です。")]
        [RegularExpression(@"^(?=.*[a-z])(?=.*[A-Z])(?=.*\d).{8,}$", 
            ErrorMessage = "パスワードは8文字以上で、英大文字、小文字、数字を各1文字以上含める必要があります。")]
        public string Password { get; set; } = string.Empty;

        [Range(18, 120, ErrorMessage = "年齢は18歳から120歳の間で入力してください。")]
        public int Age { get; set; }
    }
}

dotnet add package FluentValidation.AspNetCore

using FluentValidation;

namespace ValidationSample.Validators
{
    public class UserRegistrationValidator : AbstractValidator<UserRegistrationDto>
    {
        public UserRegistrationValidator()
        {
            // 必須チェックと長さチェック
            RuleFor(x => x.Username)
                .NotEmpty().WithMessage("ユーザー名は必須です。")
                .Length(3, 20).WithMessage("ユーザー名は3文字から20文字の間で入力してください。");

            // メールアドレスの形式と独自のドメイン制限
            RuleFor(x => x.Email)
                .NotEmpty().WithMessage("メールアドレスは必須です。")
                .EmailAddress().WithMessage("無効な形式です。")
                .Must(email => !email.EndsWith("@blocked.com"))
                .WithMessage("指定されたドメインのメールアドレスは使用できません。");

            // パスワードの複雑性
            RuleFor(x => x.Password)
                .NotEmpty()
                .MinimumLength(8)
                .Matches(@"[A-Z]").WithMessage("英大文字を含めてください。")
                .Matches(@"[a-z]").WithMessage("英小文字を含めてください。")
                .Matches(@"\d").WithMessage("数字を含めてください。");

            // 数値の範囲
            RuleFor(x => x.Age)
                .InclusiveBetween(18, 120).WithMessage("18歳から120歳の間である必要があります。");
        }
    }
}

// Program.cs
builder.Services.AddValidatorsFromAssemblyContaining<UserRegistrationValidator>();

var dto = new UserRegistrationDto { Username = "Jo", Email = "test@blocked.com", Age = 10 };
var validator = new UserRegistrationValidator();
var result = validator.Validate(dto);

if (!result.IsValid)
{
    foreach (var error in result.Errors)
    {
        Console.WriteLine($"Property: {error.PropertyName}, Error: {error.ErrorMessage}");
    }
}

public class Employee
{
    public required string Id { get; init; }
    public required string Name { get; init; }
    public string? Department { get; set; }
}

// 以下はコンパイルエラーになる
// var emp = new Employee { Name = "田中" }; // Idが足りない

public readonly record struct EmailAddress
{
    public string Value { get; }

    private EmailAddress(string value) => Value = value;

    public static EmailAddress Create(string value)
    {
        if (string.IsNullOrWhiteSpace(value) || !value.Contains("@"))
        {
            throw new ArgumentException("無効なメールアドレスです。");
        }
        return new EmailAddress(value);
    }
}

{
  "type": "https://tools.ietf.org/html/rfc7231#section-6.5.1",
  "title": "One or more validation errors occurred.",
  "status": 400,
  "errors": {
    "Username": [
      "ユーザー名は3文字以上で入力してください。"
    ],
    "Email": [
      "有効なメールアドレス形式ではありません。"
    ]
  }
}

public partial class UserValidator
{
    [GeneratedRegex(@"^[a-zA-Z0-9]+$")]
    private static partial Regex AlphanumericRegex();

    public bool IsValid(string input) => AlphanumericRegex().IsMatch(input);
}