Post­Sharp Documentation / INotify­Property­Changed / Integrating the Notify­Property­Changed Aspect with UI Frameworks / INotify­Property­Changed and Caliburn.​Micro

INotifyPropertyChanged and Caliburn.Micro

Caliburn.Micro is a popular framework designed for building applications across all XAML platforms. Caliburn.Micro includes several features, and one of those is to simplify the implementation of the INotifyPropertyChanged interface. However, Caliburn.Micro still requires you to write a lot of boilerplate code. This article shows how to use PostSharp together with Caliburn.Micro, whether because you are upgrading an existing project that already uses this framework or because you want to use the other features of Caliburn.Micro.

Without PostSharp

The example below shows a View-Model implemented according to the Caliburn.Micro specification. The class ShellViewModel inherits from the class PropertyChangedBase, which implements the INotifyPropertyChanged interface and thus is already helping you to use the Notify Property Changed pattern.

On the other hand, there is still part of the boilerplate usually appearing within the NotifyPropertyChanged pattern. For each property, you must have an explicit field, and you must manually notify all dependencies and the property itself. The result is not only more code written, but also a big space for bugs because you must discover and maintain the chain of dependent properties yourself.

C#
using Caliburn.Micro;
using System.Windows;

namespace CaliburnMicroWithPostSharp
{
    public class ShellViewModel : PropertyChangedBase
    {
        string name;

        public string Name
        {
            get { return this.name; }
            set
            {
                this.name = value;
                this.NotifyOfPropertyChange( () => this.Name );
                this.NotifyOfPropertyChange( () => this.CanSayHello );
            }
        }

        public bool CanSayHello => !string.IsNullOrWhiteSpace( this.Name );

        public void SayHello()
        {
            MessageBox.Show( $"Hello {this.Name}!" );
        }
    }
}
With PostSharp

With PostSharp, you don’t need to do any of that. You just indicate which classes should have the NotifyPropertyChanged pattern implemented using the NotifyPropertyChangedAttribute attribute and PostSharp does the hard work for you. You can see the difference in the second example, where the previous code got refactored keeping the same functionality.

C#
using System.Windows;
using PostSharp.Patterns.Model;

namespace CaliburnMicroWithPostSharp
{
    [NotifyPropertyChanged]
    public class ShellViewModel : PropertyChangedBase
    {
        public string Name { get; set; }

        public bool CanSayHello => !string.IsNullOrWhiteSpace( this.Name );

        public void SayHello()
        {
            MessageBox.Show( $"Hello {this.Name}!" );
        }
    }
}

Note that it is no longer necessary to derive your class from the PropertyChangedBase class. Even if you suppress the inheritance from PropertyChangedBase class, you can still use other Caliburn.Micro features in your code such as commands. However, if you do keep the inheritance from PropertyChangedBase, the NotifyPropertyChangedAttribute aspect will invoke the NotifyOfPropertyChange method of the PropertyChangedBase class, consistently with the coding practices of Caliburn.Micro.