Skip to content

MVVM Toolkit

dragonfavors edited this page Nov 10, 2026 · 6 revisions

Toolkit 속성과 명령

문서 홈

화면은 Screen을 상속하고, 속성과 명령은 CommunityToolkit.Mvvm 생성기를 사용합니다. 현재 패키지 참조는 8.4.2입니다.

속성과 버튼을 함께 만들기

생성기를 쓰는 프로젝트에 Toolkit 패키지를 직접 참조하고 클래스를 partial로 선언합니다.

using CommunityToolkit.Mvvm.ComponentModel;
using CommunityToolkit.Mvvm.Input;
using Gyedo;

public partial class EditorViewModel : Screen
{
    [ObservableProperty]
    [NotifyPropertyChangedFor(nameof(Heading))]
    [NotifyCanExecuteChangedFor(nameof(SaveCommand))]
    private string name = "";

    public string Heading => $"편집: {this.Name}";
    private bool CanSave() => !string.IsNullOrWhiteSpace(this.Name);

    [RelayCommand(CanExecute = nameof(CanSave))]
    private void Save()
    {
        // 저장 처리
    }
}
<TextBox Text="{Binding Name, UpdateSourceTrigger=PropertyChanged}" />
<Button Content="저장" Command="{Binding SaveCommand}" />
  • 값을 바꿀 때는 필드 name 대신 생성된 Name 속성을 사용합니다.
  • CanSave라는 이름만으로 연결되지 않습니다. CanExecute와 변경 알림을 명시합니다.
  • 외부 상태나 검증 결과가 조건을 바꾸면 SaveCommand.NotifyCanExecuteChanged()를 호출합니다.
  • 중첩 클래스에서 생성기를 쓰면 바깥 클래스도 partial이어야 합니다.

비동기 명령

Task를 반환하면 비동기 명령을 생성합니다. 다음 코드는 partial VM 클래스 안에 작성하며 System·System.Threading·System.Threading.Tasks가 필요합니다.

[RelayCommand(IncludeCancelCommand = true)]
private async Task LoadAsync(CancellationToken token)
{
    try
    {
        await Task.Delay(1000, token); // 실제 조회로 교체
    }
    catch (OperationCanceledException) when (token.IsCancellationRequested)
    {
        // 사용자가 취소함
    }
}

생성되는 이름은 LoadCommand와 LoadCancelCommand입니다. IsRunning·ExecutionTask로 실행 상태를 확인할 수 있습니다. 기본적으로 같은 명령의 중복 실행은 제한하지만 다른 명령과의 동시 실행은 별도 관리합니다.

화면을 닫는다고 임의의 명령이 자동 취소되지는 않습니다. 필요한 경우 명령 토큰과 ActivationCancellationToken을 연결하고 종료 훅에서 정리를 기다립니다. 화면 활성화 자체의 작업은 수명주기 훅을 사용합니다.

직접 작성하는 속성

VM 내부에서 다음처럼 작성할 수도 있습니다.

private string title = "";
public string Title
{
    get => this.title;
    set => this.SetProperty(ref this.title, value);
}

추가 알림은 OnPropertyChanged(nameof(Title)), 전체 알림은 파생 클래스에서 OnPropertyChanged(string.Empty)를 호출합니다.

Screen은 ObservableObject → ObservableRecipient → ValidatingModelBase를 상속합니다. 검증은 IModelValidator를 사용하므로 ObservableValidator 전용 [NotifyDataErrorInfo]는 적용하지 않습니다. 생성 콜백과 명령 알림은 UI 스레드로 자동 이동하지 않습니다. 검증 · 스레드

Clone this wiki locally