.NET Community Toolkit 8.2 版正式发布！新版本包括在运行时和 MVVM Toolkit 源码生成器中的性能改进、新代码修复程序、新的用户请求功能等内容。

(相关资料图)

.NET 社区工具包是一组适用于所有 .NET 开发人员，且与不绑定 UI 平台的帮助程序和 API。该工具包由 Microsoft 维护和发布，是 .NET 基金会的一部分，它被多个微软内部项目和应用程序使用，例如 Microsoft Store。

.NET 社区工具包的所有库最初都是 Windows 社区工具包的一部分，但随着时间的推移，仅针对 .NET 且不特定于 Windows 的 API 数量不断增加，微软决定将 .NET 相关的内容拆分到一个单独的项目中，以便它们可以独立发展，.NET Community Toolkit 由此诞生。

[RelayCommand]的自定义属性

新的 8.2.0 版本的 MVVM 工具包在使用[RelayCommand]时包括对自定义属性的支持，利用原生的field:和property:C# 语法来指示自定义属性的目标。这样一来，在使用[RelayCommand]生成 MVVM 命令时，可以完全控制所有生成成员的属性。

比如

[RelayCommand][property: JsonIgnore]private void DoWork(){    // Do some work here...}

会生成如下成员，且生成的DoWorkCommand属性具有指定的属性

private RelayCommand? _doWorkCommand;[JsonIgnore]public IRelayCommand DoWorkCommand => _doWorkCommand ??= new RelayCommand(DoWork);

相关文档

新的[ObservableProperty]更改 hook

MVVM 中一个相对常见的场景是有一些“选择的项目”可观察属性，例如当前选择的用户，或嵌套的视图模型。当此属性的值发生变化时，还必须对新旧实例进行一些调整。例如，设置一些“selected”属性，或者订阅事件。

以前，在这种情况下使用[ObservableProperty]并不理想，因为它没有必要的基础设施，来轻松注入此类逻辑以对设置的旧值和新值执行必要的状态更改。

为了解决这个问题，从 MVVM 工具包的 8.2 版本开始，为所有[ObservableProperty]字段生成了两个新的属性更改 hook。示例：

[ObservableProperty]private DocumentViewModel _selectedDocument;

现在将生成如下代码：

public DocumentViewModel SelectedDocument{    get => _selectedDocument;    set    {        if (!EqualityComparer.Default.Equals(_selectedDocument, value))        {            DocumentViewModel? oldValue = _selectedDocument;            OnNameChanging(value);            OnNameChanging(oldValue, value);            OnPropertyChanging();            _selectedDocument = value;            OnNameChanged(value);            OnNameChanged(oldValue, value);            OnPropertyChanged();        }    }}partial void OnSelectedDocumentChanging(DocumentViewModel value);partial void OnSelectedDocumentChanged(DocumentViewModel value);partial void OnSelectedDocumentChanging(DocumentViewModel? oldValue, DocumentViewModel newValue);partial void OnSelectedDocumentChanged(DocumentViewModel? oldValue, DocumentViewModel newValue);

注意正在生成的两个新的“OnPropertyNameChanging”和“Changed”方法，这两个提供了易于使用的 hook，用于注入在每个属性更改事件上触发的代码，且可以修改正在设置的旧值和新值。

MVVM 工具包代码修复器

之前版本的 MVVM Toolkit 添加了两个新的诊断分析器，它们会在错误访问标有[ObservableProperty]的字段，以及在使用声明具有[ObservableProperty]和类似属性的类型时产生警告。

在 8.2 版本中，这两个分析器还包括内置的代码修复器。只需将鼠标悬停在 IntelliSense 灯泡上，选择代码修复，该功能会自动应用所有更改，以使代码恢复到正确的状态。支持批量修复：

MVVM 工具包源代码生成器优化

MVVM Toolkit 8.2 还对其源代码生成器进行了一些性能改进。这一次重点是优化增量管道，以最大限度地减少内存使用，并确保不会在并发执行中保持不必要的对象。

以下是一些用于改进这一点的 PR：

其他改动和改进可在发布公告中查阅。