ReactiveProperty.Core 8.0.0-pre202110161410

This is a prerelease version of ReactiveProperty.Core.
There is a newer version of this package available.
See the version list below for details.
Install-Package ReactiveProperty.Core -Version 8.0.0-pre202110161410
dotnet add package ReactiveProperty.Core --version 8.0.0-pre202110161410
<PackageReference Include="ReactiveProperty.Core" Version="8.0.0-pre202110161410" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add ReactiveProperty.Core --version 8.0.0-pre202110161410
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: ReactiveProperty.Core, 8.0.0-pre202110161410"
#r directive can be used in F# Interactive, C# scripting and .NET Interactive. Copy this into the interactive tool or source code of the script to reference the package.
// Install ReactiveProperty.Core as a Cake Addin
#addin nuget:?package=ReactiveProperty.Core&version=8.0.0-pre202110161410&prerelease

// Install ReactiveProperty.Core as a Cake Tool
#tool nuget:?package=ReactiveProperty.Core&version=8.0.0-pre202110161410&prerelease
The NuGet Team does not provide support for this client. Please contact its maintainers for support.

Japanese

ReactiveProperty

ReactiveProperty provides MVVM and asynchronous support features under Reactive Extensions. Target framework is .NET 6.0(on v8.0.0-pre), .NET Core 3.1, .NET Framework 4.6.1 and .NET Standard 2.0.

Build and Release

ReactiveProperty overview

ReactiveProperty is a very powerful and simple library.

Delay and Select

This sample app's ViewModel code is as below:

public class MainPageViewModel
{
    public ReactiveProperty<string> Input { get; }
    public ReadOnlyReactiveProperty<string> Output { get; }
    public MainPageViewModel()
    {
        Input = new ReactiveProperty<string>("");
        Output = Input
            .Delay(TimeSpan.FromSeconds(1))
            .Select(x => x.ToUpper())
            .ToReadOnlyReactiveProperty();
    }
}

It's LINQ and Rx magic.

All steps are written in the "Getting Started" section in the ReactiveProperty documentation.

This library's concept is "Fun programing". ViewModel code using ReactiveProperties is very simple.

ViewModel's popular implementation:

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)
        );
    }
}

Binding code:

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

ViewModel's implementation using ReactiveProperty:

public class AViewModel
{
    public ReactiveProperty<string> Name { get; }
    public ReactiveProperty<string> Memo { get; }
    public ReactiveCommand DoSomethingCommand { get; }

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

Binding code:

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

It's very simple.

ReactiveProperty doesn't provide base class by ViewModel, which means that ReactiveProperty can be used together with another MVVM library like Prism, MVVMLight, etc...

Documentation

ReactiveProperty documentation

NuGet packages

Package Id Version and downloads Description
ReactiveProperty The package includes all core features, and the target platform is .NET Standard 2.0. It fits almost all situations.
ReactiveProperty.Core The package includes minimum classes such as ReactivePropertySlim<T> and ReadOnlyReactivePropertySlim<T>. And this doesn't have any dependency even System.Reactive. If you don't need Rx features, then it fits.
ReactiveProperty.WPF The package includes EventToReactiveProperty and EventToReactiveCommand for WPF. This is for .NET Core 3.0 or later and .NET Framework 4.6.1 or later.
ReactiveProperty.UWP The package includes EventToReactiveProperty and EventToReactiveCommand for UWP.
ReactiveProperty.XamarinAndroid The package includes many extension methods to create IObservable from events for Xamarin.Android native.
ReactiveProperty.XamariniOS The package includes many extension methods to bind ReactiveProperty and ReactiveCommand to Xamarin.iOS native controls.

Support

I'm not watching StackOverflow and other forums to support ReactiveProperty, so please feel free to post questions at Github issues. I'm available Japanese(1st language) and English(2nd language).

If too many questions are posted, then I plan to separate posting place about feature requests, issues, questions.

Author info

Yoshifumi Kawai a.k.a. @neuecc is Founder/CEO/CTO of Cysharp, Inc in Tokyo, Japan. Awarded Microsoft MVP for Developer Technologies since April, 2011. He is an original owner of ReactiveProperty.

Takaaki Suzuki a.k.a. @xin9le software developer in Fukui, Japan. Awarded Microsoft MVP for Developer Technologies since July, 2012.

Kazuki Ota a.k.a. @okazuki software developer in Tokyo, Japan. Awarded Microsoft MVP for Windows Development since July 2011 to Feb 2017. Now, working at Microsoft Japan.

  • .NETCoreApp 3.1

    • No dependencies.
  • .NETStandard 2.0

    • No dependencies.
  • net6.0

    • No dependencies.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on ReactiveProperty.Core:

Package Downloads
ReactiveProperty

ReactiveProperty is MVVM and Asynchronous Extensions for Reactive Extensions(System.Reactive). Target platform is .NET Standard 2.0.

GitHub repositories (1)

Showing the top 1 popular GitHub repositories that depend on ReactiveProperty.Core:

Repository Stars
leezer3/OpenBVE
OpenBVE- A free train simulator
Version Downloads Last updated
8.0.2 1,255 11/21/2021
8.0.1 289 11/20/2021
8.0.1-pre202111200140 414 11/20/2021
8.0.0 968 11/9/2021
8.0.0-pre202111090825 101 11/9/2021
8.0.0-pre202110240626 377 10/24/2021
8.0.0-pre202110161410 252 10/16/2021
8.0.0-pre202110160852 136 10/16/2021
8.0.0-pre202110160831 169 10/16/2021
8.0.0-pre202110131323 163 10/13/2021
8.0.0-pre202110071401 201 10/7/2021
8.0.0-pre202110060758 190 10/6/2021
8.0.0-pre202110060735 122 10/6/2021
8.0.0-pre202109190434 289 9/19/2021
8.0.0-pre202109160117 174 9/16/2021
8.0.0-pre202108141424 254 8/14/2021
8.0.0-pre202107040319 582 7/4/2021
7.12.0 8,525 8/6/2021
7.11.0 8,480 5/31/2021
7.10.0 5,418 4/29/2021
7.9.0 4,519 4/20/2021
7.8.3 5,956 3/24/2021
7.8.2 352 3/23/2021
7.8.1 1,838 3/11/2021
7.8.1-pre202103031133 272 3/3/2021
7.8.0 4,335 2/21/2021
7.8.0-pre202102210255 176 2/21/2021
7.8.0-pre202102201703 181 2/20/2021
7.7.1 491 2/19/2021
7.7.1-pre202102190925 180 2/19/2021
7.7.0 5,988 1/26/2021
7.6.1 1,838 1/15/2021
7.6.0 106,204 1/13/2021
7.5.1 19,240 10/19/2020
7.5.0 524 10/17/2020
7.5.0-pre202010141113 289 10/14/2020
7.4.1 10,025 9/23/2020
7.4.0 1,072 9/18/2020
7.3.0 487 9/17/2020
7.2.1 12,987 9/11/2020
7.2.0 24,237 8/4/2020
7.1.0 43,877 5/26/2020
7.1.0-pre202005251107 333 5/25/2020
7.0.1 1,955 5/14/2020
7.0.1-pre202005131606 296 5/13/2020
7.0.0 3,622 5/5/2020
7.0.0-ci20200503102823 330 5/3/2020
7.0.0-ci20200503100450 307 5/3/2020