ReactiveProperty.WPF 9.6.0

日语

ReactiveProperty

ReactiveProperty 为 Reactive Extensions 提供了 MVVM 和异步支持特性。目标框架是 .NET 6.0+，.NET Framework 4.7.2 和 .NET Standard 2.0。

注意

如果您正在开发新应用程序，考虑使用 R3 而不是 ReactiveProperty。R3 是由原始作者重新设计的，与当前的 .NET 生态系统保持一致，并提供了与 ReactiveProperty 相似的大部分特性。

GitHub - Cysharp/R3

概念

ReactiveProperty 是一个非常强大且简单的库。

此示例应用程序的 ViewModel 代码如下：

public class MainPageViewModel
{
    public ReactivePropertySlim<string> Input { get; }
    public ReadOnlyReactivePropertySlim<string> Output { get; }
    public MainPageViewModel()
    {
        Input = new ReactivePropertySlim<string>("");
        Output = Input
            .Delay(TimeSpan.FromSeconds(1))
            .Select(x => x.ToUpper())
            .ObserveOnDispatcher()
            .ToReadOnlyReactivePropertySlim();
    }
}

确实很简单易懂（我认为！）因为没有基类和接口。只是在输入属性和输出属性之间有声明性代码。

所有步骤均在 ReactiveProperty 文档的“入门”部分 中进行了说明。

ReactiveProperty 的概念很简单，它是一个核心类，名称为 ReactiveProperty[Slim]，它只是一个包含值的包装类，并实现了 IObservable<T> 和 INotifyPropertyChanged，IObservable<T> 用于将属性的变更事件连接到 Rx LINQ 方法的变更，INotifyPropertyChanged 用于数据绑定系统，如 WPF、WinUI 和 MAUI。

ReactiveProperty 的重要概念之一是“函数式编程”。使用 ReactiveProperty 的 ViewModel 代码非常简单。

ViewModel 的常用实现

public class AViewModel : INotifyPropertyChanged
{
    public event PropertyChangedEventHandler PropertyChanged;

    private string _name;
    public string Name
    {
        get => _name;
        set
        {
            _name = value;
            PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(nameof(Name)));

            // Update a command status
            DoSomethingCommand.RaiseCanExecuteChanged();
        }
    }

    private string _memo;
    public string Memo
    {
        get => _memo;
        set
        {
            _memo = value;
            PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(nameof(Memo)));

            // Update a command status
            DoSomethingCommand.RaiseCanExecuteChanged();
        }
    }

    // DelegateCommand is plane ICommand implementation.
    public DelegateCommand DoSomethingCommand { get; }

    public AViewModel()
    {
        DoSomethingCommand = new DelegateCommand(
            () => { ... },
            () => !string.IsNullOrEmpty(Name) && !string.IsNullOrEmpty(Memo)
        );
    }
}

绑定代码

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

使用 ReactiveProperty 的 ViewModel 实现

public class AViewModel
{
    public ValidatableReactiveProperty<string> Name { get; }
    public ValidatableReactiveProperty<string> Memo { get; }
    public ReactiveCommandSlim DoSomethingCommand { get; }

    public AViewModel()
    {
        Name = new ValidatableReactiveProperty<string>("", 
            x => string.IsNullOrEmpty(x) ? "Invalid value" : null);
        Memo = new ValidatableReactiveProperty<string>("",
            x => string.IsNullOrEmpty(x) ? "Invalid value" : null);
        DoSomethingCommand = new[]
            {
                Name.ObserveHasErrors,
                Memo.ObserveHasErrors,
            }
            .CombineLatestValuesAreAllFalse()
            .ToReactiveCommand()
            .WithSubscribe(() => { ... });
    }
}

绑定代码

<TextBlock Text="{Binding Name.Value}">
<TextBlock Text="{Binding Memo.Value}">

非常简单。

ReactiveProperty 不提供由 ViewModel 提供的基类，这意味着 ReactiveProperty 可以与其他 MVVM 库（如 Prism、Microsoft.Toolkit.Mvvm 等）一起使用。

文档

ReactiveProperty 文档

NuGet 包

包 ID	版本和下载	描述
ReactiveProperty		该包包括所有核心功能。
ReactiveProperty.Core		该包包含最小类，例如 ReactivePropertySlim<T> 和 ReadOnlyReactivePropertySlim<T>。而且这没有任何依赖，甚至没有 System.Reactive。如果您不需要 Rx 功能，那么它非常适合。
ReactiveProperty.WPF		该包包含适用于 WPF 的 EventToReactiveProperty 和 EventToReactiveCommand。这是针对 .NET 6 或更高版本和 .NET Framework 4.7.2 或更高版本。
ReactiveProperty.Blazor		该包包含对 Blazor EditForm 组件的验证支持，具有 ReactiveProperty 验证功能。这是针对 .NET 6.0 或更高版本。

以下包处于维护阶段。

包 ID	版本和下载	描述
ReactiveProperty.UWP		该包包含适用于 UWP 的 EventToReactiveProperty 和 EventToReactiveCommand。
ReactiveProperty.XamarinAndroid		该包包含许多扩展方法，可以将事件创建为 IObservable，用于 Xamarin.Android 本机。
ReactiveProperty.XamariniOS		该包包含许多扩展方法，可以将 ReactiveProperty 和 ReactiveCommand 绑定为 Xamarin.iOS 本机控件。

支持

我不会关注 StackOverflow 和其他论坛以支持 ReactiveProperty，所以请在 GitHub 问题中自由发表问题。我可以说日语（第一语言）和英语（第二语言）。

如果发出的问题太多，那么我计划将关于功能请求、问题、问题的发表地方分开。

作者信息

Yoshifumi Kawai（又名 @neuecc）是日本东京的 Cysharp，Inc 的创始人/CEO/CTO。自 2011 年 4 月以来获得微软 MVP 开发技术奖。他是 ReactiveProperty 的原始拥有者。

Takaaki Suzuki（又名 @xin9le）是日本福井的软件开发人员。自 2012 年 7 月以来获得微软 MVP 开发技术奖。

Kazuki Ota（又名 @okazuki）是日本东京的软件开发人员。自 2011 年 7 月至 2017 年 2 月获得微软 MVP Windows 开发奖。现在在微软日本工作。