ReactiveProperty 9.6.0

日语

ReactiveProperty

ReactiveProperty 提供在响应式扩展下的 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		此包包括许多扩展方法，用于从Xamarin.Android原生事件创建IObservable。
ReactiveProperty.XamariniOS		此包包括许多扩展方法，用于将ReactiveProperty和ReactiveCommand绑定到Xamarin.iOS原生控件。

支持

我不会关注StackOverflow和其他论坛来支持ReactiveProperty，所以请随意在GitHub问题处发表问题。我可用日语（第一语言）和英语（第二语言）。

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

作者信息

Yoshifumi Kawai（别名@neuecc）是位于日本东京的Cysharp，Inc的创始人/CEO/CTO。自2011年4月起被授予Microsoft MVP for Developer Technologies。他是ReactiveProperty的原始拥有者。

Takaaki Suzuki（别名@xin9le）是位于日本福井的软件开发者。自2012年7月起被授予Microsoft MVP for Developer Technologies。

Kazuki Ota（别名@okazuki）是位于日本东京的软件开发者。自2011年7月至2017年2月被授予Microsoft MVP for Windows Development。现在，他在微软日本工作。