Table of Contents

MVVM 模式

绑定模式

模式 XAML View ViewModel
View-first ViewModelLocator.AutoWireViewModel="True" XAML / new 来自 DI
ViewModel-first ContentControl Content="{Binding Vm}" 由 ViewLocator 创建 来自 DI

Options.EnableViewLocator 只控制 ViewModel-first（是否把 ViewLocator 加入 DataTemplates）。只要有映射，AutoWire 始终生效。通过 ConfigureOptions 配置：

public override void ConfigureOptions(CrystalOptions options)
{
    options.EnableViewLocator = true; // 默认
}

注册

AddMvvmTransient / AddMvvmSingleton 将 ViewModel 注册到 DI，并在 CrystalApplication.Mvvm 上记录 View 映射：

services.AddMvvmTransient<MainView, MainViewModel>();
services.AddMvvmSingleton<AboutView, AboutViewModel>();

Shell 视图（如 MainWindow 等）不在 DI 中 — 使用 CreateShell：

CreateShell<MainWindow, MainView>();

ILifecycleAware（可选）

每次 Loaded 都会调用 OnLoadedAsync。isFirstLoad 按 ViewModel 实例计算。

每次进入都刷新：

public partial class MainViewModel : ObservableObject, ILifecycleAware
{
    public Task OnLoadedAsync(bool isFirstLoad) => LoadDataAsync();
    public Task OnUnloaded() => SaveStateAsync();
}

只初始化一次（单例 ViewModel 常见）：

public Task OnLoadedAsync(bool isFirstLoad)
{
    if (!isFirstLoad) return Task.CompletedTask;
    return LoadDataAsync();
}

Tab / WebView：OnUnloaded 在离开可视树时都会触发。

EventToCommand（可选）

把 View 事件桥到 ICommand，无需 Avalonia.Xaml.Behaviors。类型已进入 默认 Avalonia xmlns（与 ViewModelLocator 相同）——不必写额外 xmlns。

单事件（简写）：

<Button Content="Save"
        EventToCommand.EventName="Click"
        EventToCommand.Command="{Binding SaveCommand}"
        EventToCommand.CommandParameter="{Binding SelectedItem}"/>

多事件：

<Border>
  <EventToCommand.Bindings>
    <EventBinding EventName="PointerPressed" Command="{Binding PressCommand}" PassEventArgs="True"/>
    <EventBinding EventName="DoubleTapped" Command="{Binding OpenCommand}"/>
  </EventToCommand.Bindings>
</Border>
API 说明
EventToCommand.Bindings / EventBinding 多个事件 → 命令
EventBinding.Command ICommand（{Binding}）
控件上的 EventName / Command 等 单事件简写

简写与 Bindings 可同时使用。优先 Avalonia 路由事件（Click → ClickEvent）。

3.1.1 的路由事件名称绑定支持 Native AOT，无需添加事件字段保留属性。 也可使用 EventToCommand.RoutedEvent 或 EventBinding.RoutedEvent 直接传入事件。 示例和 CLR 事件限制见 EventToCommand 指南。

API 摘要

API 说明
AddMvvmTransient<TView, TViewModel>() AddTransient<TViewModel>() + 映射
AddMvvmSingleton<TView, TViewModel>() AddSingleton<TViewModel>() + 映射
CreateShell<TWindow, TView>() 按平台生命周期用 new 创建 Shell
CrystalApplication.Mvvm 每应用一份映射和 ServiceProvider
CrystalApplication.Options / ConfigureOptions 每应用一份 CrystalOptions（同时是 DI 单例）
Options.EnableViewLocator 是否注册 ViewModel-first 的 ViewLocator
EventToCommand 事件 → ICommand（简写 + Bindings / EventBinding）
ILifecycleAware 可选的加载/卸载钩子

延伸阅读

工作原理： 架构原理 — MVVM 绑定 — ViewModelLocator 与 ViewLocator、映射及生命周期绑定。设计决策 — 为何 View 不在 DI 中。

Edit this page