Handy Extensions for INotifyPropertyChanged
C#
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
NotifyPropertyChangedExtensions.Tests
NotifyPropertyChangedExtensions
packages
.gitignore
Copying.txt
NotifyPropertyChangedExtensions.sln
ReadMe.md

ReadMe.md

Handy Extensions for INotifyPropertyChanged

This repository contains handy extension methods for classes implementing INotifyPropertyChanged (aka INPC). To start add the following to the top of your C# code:

using NotifyPropertyChangedExtensions;

How to easily raise INPC in a refactor friendly way

public class MyClass : INotifyPropertyChanged
{
    private int _number;

    public int Number
    {
        get { return _number; }
        set 
        { 
            if(_number != value)
            {
                _number = value; 
                this.RaisePropertyChanged(() => Number); 
            }
        }
    }

    public event PropertyChangedEventHandler PropertyChanged;
}

How to easily handle (listen to) INPC in a refactor friendly way

MyClass myObject = ...;

myObject.HandleOnPropertyChanged(src => src.Number, sender =>
    {
        Console.WriteLine("Number changed to {0}", sender.Number);
    });

How to do one-way binding from a class that implements INPC

var source = new MyClass();
var target = new TargetClass();

source.BindProperty(src => src.Number, target, t => t.Num);

source.Number = 10;
Console.WriteLine(target.Num); // 10

You can negate a boolean property while binding it. I use it a lot and find it very handy.

source.BindProperty(src => src.IsActive, target, t => !t.IsDeleted);

source.IsActive = false;
Console.WriteLine(target.IsDeleted); // True

You can bind primitive data-types in source class to Nullable primitive data-types in the target class, and vice versa.

source.BindProperty(src => src.Number, target, t => t.NullableNumber);

What happens if source is null, and the target is not Nullable?

The default behavior is to update target with default value of that type:

target.Number = 10;
source.BindProperty(src => src.NullableNumber, target, t => t.Number);

source.NullableNumber = null;
Console.WriteLine(target.Number); // 0

You can also choose not to update target if source becomes null:

target.Number = 10;
source.BindProperty(src => src.NullableNumber, target, t => t.Number, 
    BindPropertyOptions.DontUpdateWhenSourceIsNullAndTargetIsNotNullable);

source.NullableNumber = null;
Console.WriteLine(target.Number); // still 10

How can I find more information about this library?

At the moment the best way to find out how this library works is by reading the unit tests or at least their titles.

License

MIT