CommunityToolkit.Mvvm + Microsoft.Extensions.DependencyInjection

O MVVM Toolkit deliberadamente não inclui um contêiner de DI — ele se compõe com Microsoft.Extensions.DependencyInjection, o mesmo contêiner que ASP.NET Core, Worker services e o .NET Generic Host utilizam.

Resumo. Crie o provedor de serviços uma vez na inicialização (prefira Host.CreateDefaultBuilder()). Registre serviços e ViewModels. Injete através de construtores. Evite Ioc.Default.GetService<T>() no código do usuário.

Quando usar esta habilidade

• Configurar a raiz de composição para um novo aplicativo XAML (WPF, WinUI 3, MAUI, Uno, Avalonia)
• Escolher tempos de vida de serviço/VM
• Configurar IMessenger uma vez e injetá-lo em ObservableRecipient ViewModels
• Resolver o ViewModel de uma página sem acoplamento a um localizador de serviços
• Diagnosticar "Unable to resolve service for type X while attempting to activate Y"

Para geradores de código-fonte e padrões de ViewModel, consulte a habilidade mvvm-toolkit. Para pub/sub do Messenger, consulte mvvm-toolkit-messenger.

Raiz de composição recomendada (Generic Host)

using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;
using CommunityToolkit.Mvvm.Messaging;

public partial class App : Application
{
    public IHost Host { get; }

    public App()
    {
        Host = Microsoft.Extensions.Hosting.Host
            .CreateDefaultBuilder()
            .ConfigureServices((_, services) =>
            {
                services.AddSingleton<IFilesService, FilesService>();
                services.AddSingleton<ISettingsService, SettingsService>();
                services.AddSingleton<IMessenger>(WeakReferenceMessenger.Default);

                services.AddSingleton<ShellViewModel>();
                services.AddTransient<ContactViewModel>();
                services.AddTransient<EditorViewModel>();
            })
            .Build();
    }

    public static T GetService<T>() where T : class =>
        ((App)Current).Host.Services.GetRequiredService<T>();
}

Benefícios do Generic Host:

• Vinculação appsettings.json via Microsoft.Extensions.Configuration
• Logging via Microsoft.Extensions.Logging
• Serviços hospedados (IHostedService) para trabalho em segundo plano
• Validação de escopo em builds de desenvolvimento

WPF e Windows Forms devem integrar o tempo de vida do host com o tempo de vida do aplicativo — consulte Use o .NET Generic Host em um aplicativo WPF.

Sem Generic Host

Quando você precisa apenas de um contêiner de serviços e deseja zero dependências extras:

var services = new ServiceCollection();
services.AddSingleton<IFilesService, FilesService>();
services.AddTransient<ContactViewModel>();
ServiceProvider provider = services.BuildServiceProvider();

Injeção de construtor

Injete serviços e ViewModels filhos através do construtor:

public sealed partial class ContactViewModel(
    IFilesService files,
    IMessenger messenger,
    ILogger<ContactViewModel> logger)
    : ObservableRecipient(messenger)
{
    [ObservableProperty]
    private string? name;

    [RelayCommand]
    private async Task SaveAsync()
    {
        logger.LogInformation("Saving {Name}", Name);
        await files.SaveAsync(Name!);
    }
}

Por que a injeção de construtor supera um localizador de serviços:

• As dependências são explícitas e visíveis no local da chamada
• Testes de unidade injetam fakes/mocks diretamente
• O contêiner de DI valida o grafo de dependência na inicialização
• Registros ausentes lançam erros imediatamente, não no primeiro uso

Tempos de vida

services.AddSingleton<ShellViewModel>();   // 1 instance for app lifetime
services.AddTransient<NoteViewModel>();    // new instance per resolve
services.AddScoped<DialogService>();       // 1 per scope (rare)

Resolvendo em uma View

Resolva o ViewModel raiz da página no código-behind e, em seguida, deixe-o buscar suas próprias dependências:

public sealed partial class ContactPage : Page
{
    public ContactViewModel ViewModel { get; }


…