Skip to content

Validation

dragonfavors edited this page Nov 10, 2026 · 5 revisions

입력 검증

문서 홈

Screen은 IModelValidator의 검증 결과를 HasErrors, GetErrors, ErrorsChanged로 전달합니다. Toolkit의 ObservableValidator는 아니므로 [NotifyDataErrorInfo]를 붙이지 않습니다.

VM과 검증기

using CommunityToolkit.Mvvm.ComponentModel;
using CommunityToolkit.Mvvm.Input;
using Gyedo;
using System.Threading.Tasks;

public partial class ProfileViewModel : Screen
{
    [ObservableProperty]
    private string name = "";

    public ProfileViewModel(IModelValidator<ProfileViewModel> validator) : base(validator) { }

    [RelayCommand]
    private async Task SaveAsync()
    {
        if (!await this.ValidateAsync()) return;
        // 저장 처리
    }
}

검증기는 Initialize에서 대상 VM을 받습니다. 유효한 항목도 빈 오류 목록 또는 null로 반환해 이전 오류를 지웁니다.

using Gyedo;
using System;
using System.Collections.Generic;
using System.Threading.Tasks;

public sealed class ProfileValidator : IModelValidator<ProfileViewModel>
{
    private ProfileViewModel model = null!;
    public void Initialize(object subject) => this.model = (ProfileViewModel)subject;

    private IEnumerable<string> NameErrors() =>
        string.IsNullOrWhiteSpace(this.model.Name)
            ? new[] { "이름을 입력하세요." }
            : Array.Empty<string>();

    public Task<IEnumerable<string>> ValidatePropertyAsync(string propertyName) =>
        Task.FromResult(propertyName == nameof(ProfileViewModel.Name) || string.IsNullOrEmpty(propertyName)
            ? this.NameErrors() : Array.Empty<string>());

    public Task<Dictionary<string, IEnumerable<string>>> ValidateAllPropertiesAsync() =>
        Task.FromResult(new Dictionary<string, IEnumerable<string>>
        {
            [nameof(ProfileViewModel.Name)] = this.NameErrors(),
        });
}

ConfigureServices에서 등록합니다. 상태 있는 검증기를 여러 VM에 Singleton으로 공유하지 않습니다.

services.AddTransient<IModelValidator<ProfileViewModel>, ProfileValidator>();

WPF 오류 표시

<TextBox Text="{Binding Name, UpdateSourceTrigger=PropertyChanged,
                       ValidatesOnNotifyDataErrors=True}" />

오류 문구·스타일은 WPF Validation.Errors를 사용하는 UI에서 구성합니다.

검증 시점

기능 동작
AutoValidate 기본 true. 속성 변경 시 해당 속성을 검증
ValidateAsync() 전체 검증. 저장 직전에 await
ValidatePropertyAsync(name) 지정한 속성 검증
RecordPropertyError / ClearAllPropertyErrors 수동 오류 기록 / 전체 해제

자동 검증의 완료를 속성 setter에서 기다리지는 않습니다. 비동기 검증이 겹치면 오래된 결과가 최신 입력을 덮어쓰지 않도록 검증기에서 조율합니다.

HasErrors를 버튼 실행 조건으로 쓰면 검증 결과 변경 후 NotifyCanExecuteChanged()도 호출합니다. 속성·오류 알림에는 PropertyChangedDispatcher가 적용되지만 명령 알림까지 자동 전달하지는 않습니다.

FluentValidation 샘플에서 제출 버튼 갱신과 비밀번호 확인 재검증을 볼 수 있습니다.

Clone this wiki locally