ReactiveProperty.XamariniOS 9.5.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 的一个重要概念是 "Fun programming"。使用 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		该包包含了ReactiveProperty验证特性对Blazor EditForm组件的支持。这是.NET 6.0或更高版本。

以下包处于维护阶段。

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

支持

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

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

作者信息

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奖项。现在，他在微软日本工作。