Oakrey.ViewModels 3.0.0

Oakrey.ViewModels

Oakrey.ViewModels provides small MVVM helpers for WPF applications: base view model classes, relay commands, observable collections, dispatcher-aware events, and hyperlink commands.

Features

• ViewModelBase implements INotifyPropertyChanged and includes SetProperty helpers for concise property setters.
• DisposableViewModelBase manages subscriptions through a CompositeDisposable and exposes disposal guards for derived view models.
• RelayCommand, RelayCommand<T>, and CommandBase support WPF command binding and manual RaiseCanExecuteChanged notifications.
• LazyCommandFactory creates lazily initialized commands for view models that should defer command allocation.
• AsyncObservableCollection<T> provides snapshot-based enumeration and dispatcher-aware collection/property change notifications.
• ObservableQueue<T> raises collection/property notifications and can safely operate without a current WPF Application dispatcher.
• Hyperlink helpers validate URI schemes before opening links through the shell.

Installation

dotnet add package Oakrey.ViewModels

Package Manager Console:

Install-Package Oakrey.ViewModels

Examples

Use SetProperty in a view model:

public sealed class UserViewModel : ViewModelBase
{
    private string name = string.Empty;

    public string Name
    {
        get => name;
        set => SetProperty(ref name, value);
    }
}

Create a command:

public ICommand SaveCommand { get; } = new RelayCommand(_ => Save(), _ => CanSave);

Use a typed command:

public ICommand OpenCommand { get; } = new RelayCommand<string>(Open, path => !string.IsNullOrWhiteSpace(path));

Create a dispatcher-aware observable queue:

ObservableQueue<string> queue = new();
queue.Enqueue("Ready");

if (queue.TryDequeue(out string? message))
{
    Console.WriteLine(message);
}

Notes

• RelayCommand<T>.CanExecute(object?) returns false for invalid command parameters; Execute(object?) still throws to surface binding/configuration mistakes.
• HyperlinkHelper allows http, https, and mailto links by default.
• ObservableQueue<T> falls back to direct invocation when no WPF application dispatcher is available, which makes it easier to use in tests and non-visual code.

Requirements

• .NET 10 Windows target (net10.0-windows)
• WPF enabled project

Project Information

• Author: Oakrey
• Company: Oakrey (Website)
• License: MIT
• Repository: Git Repository
• Project URL: NuGet