Extensions.Hosting.Wpf 4.0.0

Microsoft.Extensions.Hosting.Wpf

Unofficial implementation of Microsoft.Extensions.Hosting for WPF. It is inspired by Dapplo and this extensions is focused only on WPF and doesn't have Plugins, SingleInstance etc features like Dapplo. It's main feature is to provide the ability to bind DataContext with ViewModels directly in XAML where the ViewModel gets resolved by DI. This library also has few extensions packages to add features like tray icon, thread switching between main thread and threadpool thread, 3rd party DI support.

Changelog | Wiki

NuGet Packages

Name	Description	Latest version
Extensions.Hosting.Wpf	The main library, with Microsoft.Extensions.Hosting for WPF support.
Extensions.Hosting.Wpf.TrayIcon	An extension enabling tray icon support.
Extensions.Hosting.Wpf.Threading	An extension enabling thread switching between Main UI Thread and ThreadPool Thread via Microsoft.VisualStudio.Threading.
Extensions.Hosting.Wpf.Bootstrap	An extension enabling easier bootstrap for 3rd-party DI containers. Requires an explicit Extensions.Hosting.Wpf reference as of 4.0.0.

Quick Start

1. Add IApplicationInitializeComponent to App.xaml.cs

public partial class App : Application, IApplicationInitializeComponent
{
}

2. Create Program.cs

public class Program
{
    public static void Main(string[] args)
    {
        using IHost host = CreateHostBuilder(args).Build();
        host.Run();
    }

    private static IHostBuilder CreateHostBuilder(string[] args)
    {
        return Host.CreateDefaultBuilder(args)
            .ConfigureServices(ConfigureServices);
    }

    private static void ConfigureServices(HostBuilderContext hostContext, IServiceCollection services)
    {
        services.AddWpf<App>();
    }
}

3. Update .csproj

<StartupObject>[Namespace].Program</StartupObject>

For the full guide including ViewModel Locator, constructor injection, and more, see the Wiki.

Samples

1. HostingSimple: A minimalistic, beginner-friendly introduction. Offers a basic starting point for understanding the framework.
2. HostingReactiveUI: An advanced example using NLog for logging, ReactiveUI as the MVVM framework, and the TrayIcon feature.
3. HostingReactiveUISimpleInjector: Incorporates SimpleInjector alongside ReactiveUI. Demonstrates that you're not limited to Microsoft.DependencyInjection.
4. HostingReactiveUISimpleInjectorAmbientScope: Demonstrates AsyncScopedLifestyle with SimpleInjector for ambient-scoping and integrates Threading.
5. HostingReactiveUISimpleInjectorFlowingScope: Demonstrates ScopedLifestyle.Flowing with SimpleInjector for closure-scoping. Presents an alternative approach without ViewModelLocatorHost.

Documentation

Full documentation is available in the Wiki:

Extensions.Hosting.Wpf.Bootstrap no longer includes Extensions.Hosting.Wpf transitively starting with 4.0.0, so bootstrap consumers must install both packages explicitly.

• Getting Started — Minimal setup guide
• ViewModelLocator Feature — Bind DataContext in XAML via DI
• Constructor Injection in App — Inject services into your App class
• Threading — Switch between UI and background threads
• TrayIcon — System tray icon support
• Bootstrap (3rd-party DI) — SimpleInjector, Autofac, and other DI containers
• Architecture & How It Works — Internal architecture and lifecycle
• API Reference — Complete API reference
• FAQ & Troubleshooting — Common questions and error solutions