Monumend.Net 2.0.3

Monumend.Net

A powerful .NET Standard 2.0 library providing configurable INotifyPropertyChanged implementation with extended event arguments that track both old and new values.

Features

? Configurable Behavior - Switch between API and Client modes
?? Extended Event Args - Track old and new property values
?? Thread-Safe - Safe event handler capture using Interlocked
?? Type-Safe - Generic implementation with compile-time type checking
? Performance Optimized - Conditional equality checking and event raising
?? Framework Agnostic - Works with WPF, Xamarin, MAUI, Avalonia, Blazor

Installation

dotnet add package Monumend.Net

Or via Package Manager Console:

Install-Package Monumend.Net

Quick Start

1. Configure on Startup

// In your application startup (e.g., App.xaml.cs for WPF)
using Monumend.Net.Models;

// For client applications (UI)
NotifyPropertyChangedExtensions.Configure(
    NotifyPropertyChangedExtensions.ClientConfiguration);

// For API/server applications
NotifyPropertyChangedExtensions.Configure(
    NotifyPropertyChangedExtensions.ApiConfiguration);

2. Create ViewModels

using Monumend.Net.Models;

public class PersonViewModel : VMO
{
    private string? _name;
    private int _age;

    public string? Name
    {
        get => _name;
        set => Set(value, ref _name);  // Clean and intuitive!
    }

    public int Age
    {
        get => _age;
        set
        {
            bool? changed = Set(value, ref _age);
            if (changed == true)
            {
                // Age changed - notify dependent property with automatic property name capture
                OnPropertyChanged(Age < 18, value >= 18);  // propertyName is automatically captured
            }
        }
    }

    public bool IsAdult => Age >= 18;
}

Tip: If your application targets .NET 8+, you can use the C# 13 field keyword for even cleaner code. See the "Using C# 13 Field Keyword" section below.

3. Subscribe to Changes

var person = new PersonViewModel();

// Standard PropertyChanged handler
person.PropertyChanged += (sender, e) =>
{
    Console.WriteLine($"Property {e.PropertyName} changed");
};

// Extended handler with old/new values
person.PropertyChanged += (sender, e) =>
{
    if (e is PropertyChangedExtendedEventArgs<string> args)
    {
        Console.WriteLine($"Name changed from '{args.OldValue}' to '{args.NewValue}'");
    }
};

person.Name = "John"; // Triggers both handlers

Advanced Usage

Custom Configuration

var customConfig = new NotifyPropertyChangedExtensions.Configuration
{
    RaiseEvents = true,
    CheckForValueChange = true
};

NotifyPropertyChangedExtensions.Configure(customConfig);

Value Change Detection

// Traditional backing field approach
private int _score;
public int Score
{
    get => _score;
    set
    {
        bool? changed = Set(value, ref _score);
        if (changed == true)
        {
            // Score actually changed - recalculate dependent properties
            RecalculateRanking();
            OnPropertyChanged(oldRank, newRank);  // propertyName automatically captured
        }
    }
}

// Modern C# 13 field keyword approach
public int Score
{
    get;
    set
    {
        bool? changed = Set(value, ref field);
        if (changed == true)
        {
            // Score actually changed
            RecalculateRanking();
        }
    }
}

Triggering Dependent Property Changes

public class PersonViewModel : VMO
{
    private string? _firstName;
    private string? _lastName;

    public string? FirstName
    {
        get => _firstName;
        set
        {
            if (Set(value, ref _firstName) == true)
            {
                // When FirstName changes, notify that FullName also changed
                NotifyPropertyChanged(nameof(FullName));
            }
        }
    }

    public string? LastName
    {
        get => _lastName;
        set
        {
            if (Set(value, ref _lastName) == true)
            {
                NotifyPropertyChanged(nameof(FullName));
            }
        }
    }

    public string FullName => $"{FirstName} {LastName}";
}

// Or using C# 13 field keyword
public class ModernPersonViewModel : VMO
{
    public string? FirstName
    {
        get;
        set
        {
            if (Set(value, ref field) == true)
            {
                NotifyPropertyChanged(nameof(FullName));
            }
        }
    }

    public string? LastName
    {
        get;
        set
        {
            if (Set(value, ref field) == true)
            {
                NotifyPropertyChanged(nameof(FullName));
            }
        }
    }

    // Important: Use property names, not backing fields
    public string FullName => $"{FirstName} {LastName}";
}

Manual Property Notification

public class PersonViewModel : VMO
{
    private string? _firstName;
    private string? _lastName;
    
    public string? FirstName
    {
        get => _firstName;
        set
        {
            if (Set(value, ref _firstName) == true)
            {
                // Option 1: Simple notification (v2.0.2+)
                OnPropertyChanged(nameof(FullName));
                
                // Option 2: With old/new values (v2.0.1+)
                // OnPropertyChanged(oldFullName, newFullName, nameof(FullName));
            }
        }
    }
    
    public string? LastName
    {
        get => _lastName;
        set
        {
            if (Set(value, ref _lastName) == true)
            {
                // Simple notification when you don't need value tracking
                OnPropertyChanged(nameof(FullName));
            }
        }
    }
    
    public string FullName => $"{FirstName} {LastName}".Trim();
    
    // Batch refresh multiple computed properties
    public void RefreshCalculatedProperties()
    {
        OnPropertyChanged(nameof(FullName));
        OnPropertyChanged(nameof(DisplayName));
        OnPropertyChanged(nameof(Summary));
    }
}

When to use each OnPropertyChanged overload:

Version History

• v2.0.2 - Added protected OnPropertyChanged(string) overload for simple notifications
• v2.0.1 - Improved OnPropertyChanged API with CallerMemberName support
• v2.0.0 - Refactored API with improved parameter order Set(value, ref backingField)
• v1.1.0 - Cleaned up API, removed redundant methods
• v1.0.1 - Added package icon
• v1.0.0 - Initial release