Win Application Framework (WAF)

Successor of the WPF Application Framework

The Win Application Framework (WAF) is a lightweight Framework that helps you to create well-structured XAML Applications (MAUI, Xamarin, WPF, WinUI). It supports you in applying various architectural patterns:

How to get started?

WAF comes with realistic real-world sample applications. Please have a look at them. See Sample Applications below.
The Wiki provides further guidance.

Supported Platforms

*.Core (.NET 6.0 and .NET Standard 2.0): Support for all .NET based applications.
*.Wpf (.NET 6.0 and .NET Framework 4.7.2): Extended support for Windows Presentation Foundation (WPF).

NuGet Packages

Package	Usage	Successor of
System.Waf.Core	For all .NET based applications
System.Waf.Wpf	For WPF applications	waf
System.Waf.UnitTesting.Core	For unit testing of all .NET based applications
System.Waf.UnitTesting.Wpf	For unit testing of WPF applications	waf.testing

Features

System.Waf.Core

Foundation
- Cache: Provides support for caching a value.
- Model: Base class that implements INotifyPropertyChanged.
- ObservableList: Extends the ObservableCollection with support for INotifyCollectionChanging and INotifyCollectionItemChanged.
- ObservableListViewCore: Provide change notifications for sorting and filtering.
- SynchronizingList: Represents a collection that synchronizes all its items with the items of the specified original collection.
- ThrottledAction: Throttling of multiple method calls to improve the responsiveness of an application.
- ValidatableModel: Base class for a model that supports validation by implementing INotifyDataErrorInfo.
- WeakEvent: Supports listening to events via a weak reference. This can prevent memory leaks. See WeakEvent page for more details.
Applications
- ApplicationInfo: Provides information about the running application.
- (Async)DelegateCommand: An implementation of ICommand that delegates Execute and CanExecute.
- RecentFileList: Most recently used (MRU) file list.
- ViewModelCore: ViewModel base class with a simple approach to set the DataContext.
Presentation
- SettingsService: Load and save user settings as a XML file.

System.Waf.Wpf

Foundation
- DataErrorInfoSupport: Helper class for working with the legacy IDataErrorInfo interface.
Applications
- ViewModel: Extends the ViewModelCore class and automatically initializes the DataContext with the Dispatcher.
Presentation
- DispatcherHelper: Implementation for DoEvents.
- ResourceHelper: Helper methods to manage resources in WPF.
- ValidationHelper: Support for data validation tracking.
- Converters
  - BoolToVisibilityConverter: Converts a boolean value to and from a Visibility value.
  - InvertBooleanConverter: Inverts a boolean value.
  - NullToVisibilityConverter: Check for null and return the associated Visibility value.
  - StringFormatConverter: Converts an object into a formatted string.
  - ValidationErrorsConverter: Converts a ValidationError collection to a multi-line string error message.
- Services
  - FileDialogService: Shows an open or save file dialog box.
  - MessageService: Shows messages via the MessageBox.

System.Waf.UnitTesting.Core

AssertHelper: Assertion helper methods for expected exceptions, CanExecuteChanged event and PropertyChanged event.
UnitTestSynchronizationContext: Synchronization context for unit tests that simulates the behavior of a UI synchronization context.

Sample Applications