ReactiveProperty.Blazor 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 方法的 chane，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		该包包含具有ReactiveProperty验证功能的Blazor EditForm组件的验证支持。这是针对.NET 6.0或更高版本。

以下包处于维护阶段。

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

支持

我不会关注StackOverflow和其他论坛以支持ReactiveProperty，因此请随时在Github issues处发布问题。我提供日语（第一语言）和英语（第二语言）。

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

作者信息

Yoshifumi Kawai（昵称@neuecc）是东京Cysharp, Inc的创始人/CEO/CTO。自2011年4月起获得Microsoft MVP Developer Technologies奖。他是ReactiveProperty的原始拥有者。

Takaaki Suzuki（昵称@xin9le）是日本福井的软件开发者。自2012年7月起获得Microsoft MVP Developer Technologies奖。

Kazuki Ota（昵称@okazuki）是日本东京的软件开发者。自2011年7月至2017年2月获得Microsoft MVP Windows Development奖。现在在Microsoft日本工作。