新しいViewModelの記述方法

早速ですが新旧の書き方比較をしてみます。
最初に旧来(ver7)の方法で、変更通知できる Name プロパティと GreetCommand コマンドを書いてみます。

Vm.cs (ver7)

internal class Vm : ObservableObject
{
    private string _name;
    public string Name 
    {
        get => _name;
        set => SetProperty(ref _name, value);
    }

    private IRelayCommand<string> greetCommand;

    public IRelayCommand<string> GreetCommand => greetCommand ??= new RelayCommand<string>(Greet);

    private void Greet(string user)
    {
        Debug.WriteLine($"Hello {user}!");
    }
}

これをver8で書くと以下のコードになります。

Vm.cs (ver8)

[INotifyPropertyChanged]
internal partial class Vm
{
    [ObservableProperty]
    private string name;

    [RelayCommand]
    private void Greet(string user) {
        Debug.WriteLine($"Hello {user}!");
    }
}

ずいぶんと短くなりました。作ったプロパティやコマンドすら見当たらないですが、1つずつ説明していきます。

コードを簡潔に

C#の進化とともにMVVMのコード記述量は減りましたがそれでもまだ面倒でスニペットや便利なライブラリが良く使われます。海外では ReactiveUI、日本では ReactivePropertyあたりでしょうか。 Fody のようにILを直接書き換えるのも面白い試みです。
（興味ある方は @soi さんの INotifyPropertyChangedプロパティ実装方法まとめ C#3からC#7、Fodyもをご覧ください）

今回のMVVM Toolkit ver8では roslyn のソースジェネレータで解決してます。
面倒なコードはコンパイラが生成しているのでライブラリにありがちなオーバヘッドもありません。

ViewModelクラス定義

ver7までは ObservableObject (他ライブラリでいうBindableBase) を継承していました。

internal class Vm : ObservableObject
{
}

上の書き方でもOKですが、ver8からINotifyPropertyChanged属性で作れるようになります。またソースジェネレータのために partial にします。

[INotifyPropertyChanged]
internal partial class Vm
{
}

C# は多重継承ができないため、データバインディング用に基底クラスを使うとほかのクラスを継承できなかった問題が解決します。

ICommandの記述

ICommandはこれまで以下のように実装していました。

private IRelayCommand<string> greetCommand;

public IRelayCommand<string> GreetCommand => greetCommand ??= new RelayCommand<string>(Greet);

private void Greet(string user)
{
    Debug.WriteLine($"Hello {user}!");
}

ver8からは[RelayCommand]属性を付けることで ～Command が自動生成されます。（previewでは「ICommand」属性でしたがver8.0正式版で「RelayCommand」属性に変更）

[RelayCommand]
private void Greet(string user)
{
    Debug.WriteLine($"Hello {user}!");
}

XAMLからの使い方は変わりません。

xaml

<Button Content="Greet" Command="{Binding GreetCommand}" CommandParameter="test" />

変更通知プロパティ

INotifyPropertyChanged実装プロパティはいままでは以下のように記述していました。C#の進化とライブラリによってだいぶ短く書けるようになりました。

private string _name;
public string Name 
{
    get => _name;
    set => SetProperty(ref _name, value);
}

ver8からは以下のように書けます。

// ver8.0
// Name プロパティが自動生成される。
[ObservableProperty]
private string name;

さらにver8.4で部分プロパティに対応しました！

//ver8.4以降はプロパティを書けます
[ObservableProperty]
public partial string Name { get; set; };

ver8.0はバッキングフィールド nameを書いていましたが、ver8.4以降はNameプロパティを記述できるようになりました。ただしC#13時点(.NET9/2024年)では以下の注意点が必要です。

プロパティにpertialキーワードが必要です。
C#13に field キーワードが盛り込まれなかったため、csprojファイルに<LangVersion>preview</LangVersion>が必要です。

XAMLでの使い方は変わりません。

xaml

<TextBlock Text="{Binding Name}" />

また、変更通知プロパティで変更前と変更後に処理を挟みたい時があります。Onプロパティ名Changing()、Onプロパティ名Changed() というメソッドを用意しておくと勝手に呼び出されるようになります。（詳しくはpreview3の紹介記事を参照)

[ObservableProperty]
private string name;

partial void OnNameChanging(string name)
    =>Console.WriteLine($"Nameプロパティが {name} に変更されようとしてます");

partial void OnNameChanged(string name)
    =>Console.WriteLine($"Nameプロパティが {name} に変更されました");

おわりに

以下ver8.0時点の感想はコメントアウト、継続的に改善されるライブラリはいいですね。

MVVMのコード記述が減るのは大歓迎ですが、この書き方で良いのかは疑問が残ります。僕らが望んでいたのは表(プロパティ等)を書いたら裏(backing-field等)を自動生成してくれる、だったのですが逆になってます。確かにソースジェネレータならこうなるよな、とは思うのですが・・。コード書く人はVisualStudioのインテリセンスで何とかなりますが、コードを読む人は自動生成された表側を推測しないといけないのが難点です。~~

→2年越しにver8.4で部分プロパティに対応したため、読みやすさも改善したと思われます。C#13に未導入のfield機能を使わなくても実装出来たろうに、と思うことはありますが。