ReactiveProperty.Core 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 的 change 方法，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 可以与 Prism、Microsoft.Toolkit.Mvvm 等其他 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		该包包括用于 Xamarin.Android 原生的许多扩展方法，以从事件创建 IObservable。
ReactiveProperty.XamariniOS		该包包括将 ReactiveProperty 和 ReactiveCommand 绑定到 Xamarin.iOS 原生控件上的许多扩展方法。

支持

我不会关注 StackOverflow 和其他论坛来支持 ReactiveProperty，因此请随时在 Github issue 中发布问题。我可用日语（第一语言）和英语（第二语言）。

如果发布的问题太多，那么我计划为功能请求、问题、问题分离发布位置。

作者信息

Yoshifumi Kawai（别称 @neuecc）是日本东京 CyberNoboru，Inc 的创始人/CEO/CTO。自 2011 年 4 月以来获得 Microsoft MVP（开发者技术）奖。他是 ReactiveProperty 的原始所有者。

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

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