0 Fork 0

Files

T

2026-10-27 19:01:56 +08:00

3.0 KiB

Raw Blame History

name, description, disable-model-invocation

name	description	disable-model-invocation
add-view	在 PipeReviewReport 客户端现有模块中新建一个 View + ViewModel 对。当用户需要在模块内添加新页面、子视图时使用。	false

新建 View + ViewModel

命名约定（关键）

View 和 ViewModel 的命名遵循统一规则：

Xxx = 功能名称（不含 View 后缀），如 AlarmLog、MonitorMain、ParameterConfig
View 文件：XxxView.xaml（如 AlarmLogView.xaml）
ViewModel 类：XxxViewModel（如 AlarmLogViewModel）
ViewModel 文件（拆分时）：ViewModels/XxxViewModel.cs

命名反例（禁止）：

❌ 错误	✅ 正确	说明
`AlarmLogViewViewModel.cs`	`AlarmLogViewModel.cs`	`Xxx` = `AlarmLog`，不要保留 View 后缀
`MainConsoleMainViewViewModel.cs`	`MainConsoleMainViewModel.cs`	同理
`DataManagementViewViewModel.cs`	`DataManagementViewModel.cs`	同理

当用户提到的功能名已包含 "View" 后缀时，必须去掉它再添加 ViewModel 后缀。

Step 1 — 创建 ViewModel

优先将 ViewModel 写在 .xaml.cs 文件末尾（UserControl class 之后），视图不复杂时无需单独建文件：

// XxxView.xaml.cs

namespace PipeReviewReport.<模块名>.Views;

public partial class XxxView : UserControl
{
    public XxxView() => InitializeComponent();
}

internal class XxxViewModel : ViewModelBaseEx
{
    protected override void LoadedOnce()
    {
        // 首次加载初始化
    }
}

ViewModel 逻辑较多导致文件过长时，再拆到 ViewModels/XxxViewModel.cs 单独文件。

Step 2 — 创建 View（XAML）

先读取 Source/XAML_Preset.txt 中 -------------- View -------------- 区段，复制全部 xmlns 属性，然后创建：

<UserControl
    x:Class="PipeReviewReport.<模块名>.Views.XxxView"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:local="clr-namespace:PipeReviewReport.<模块名>.Views"
    xmlns:core="MAX.Core"
    ...（其余 xmlns 从 XAML_Preset.txt 复制）
    d:DataContext="{d:DesignInstance Type=local:XxxViewModel}"
    Style="{DynamicResource UserControlStyle}"
    DataContext="{core:DISource Type=local:XxxViewModel}"
    d:DesignHeight="450"
    d:DesignWidth="800">
    <Grid>
    </Grid>
</UserControl>

Step 3 — code-behind

保持最简，不写业务逻辑：

namespace PipeReviewReport.<模块名>.Views;

public partial class XxxView : UserControl
{
    public XxxView()
    {
        InitializeComponent();
    }
}

检查清单

ViewModel 继承 ViewModelBaseEx
View 设置 Style="{DynamicResource UserControlStyle}"
View 使用 DataContext="{core:DISource Type=local:XxxViewModel}" 绑定
d:DataContext 设计时数据上下文已配置
code-behind 无业务逻辑
输入框已显式 MaxLength="{x:Static shared:InputLimits.Path/Text}"（路径片段用 Path；完整路径用选择器，不要手输）

3.0 KiB Raw Blame History Unescape Escape