WinUI3/UWP UserControl：暴露属性还是绑定ViewModel？

一、一般优先选择哪种方式？ #

优先选择**暴露DependencyProperty（依赖属性）**的方式。原因如下：

• 这是UWP/WinUI 3框架原生的控件交互模式，完全贴合XAML控件设计规范，能和系统内置控件保持一致的使用体验，支持数据绑定、样式修改、动画触发等核心特性。
• 控件复用性更强，不依赖特定的ViewModel结构，任何符合属性类型的数据都能绑定适配，适配不同场景的ViewModel设计。

二、选择是否因Control、UserControl、Page类型不同有差异？ #

差异非常明显：

• Control：必须优先使用依赖属性。Control是更底层的自定义控件（比如继承自ContentControl、ItemsControl），核心目标是成为通用UI组件，完全和业务ViewModel解耦是硬性要求，只能通过暴露依赖属性对外提供交互接口。
• UserControl：两种方式都可行，但仍优先依赖属性。UserControl是已有控件的组合封装，若要作为通用组件复用，依赖属性是标准做法；如果只是当前页面的局部专属封装，且完全绑定当前页面ViewModel，也可以直接绑定，但这种场景下控件复用性会大幅降低。
• Page：直接绑定ViewModel是常规操作。Page本身是业务页面的载体，和特定业务ViewModel强绑定是合理设计，几乎不需要暴露依赖属性（除非作为嵌套页面被其他页面复用，但这种场景极少）。

三、如何判断何时为UserControl暴露属性，何时直接绑定ViewModel？ #

可以从两个核心维度判断：

1. 复用需求 #

• 如果UserControl需要在多个页面、多个业务场景中复用（比如Material UI的卡片组件，可能在列表、详情页等多处使用），必须暴露依赖属性。比如卡片需要显示标题、内容、操作按钮文本，就定义CardTitle、CardContent、ActionButtonText等依赖属性，让使用方根据各自ViewModel绑定对应字段。
• 如果UserControl只是当前页面的专属局部组件（比如某个页面特有的筛选栏，只服务于当前页面的ViewModel），可以直接绑定当前页面的ViewModel，无需额外定义依赖属性。

2. 耦合程度 #

• 若希望UserControl与业务逻辑完全解耦，只负责UI展示和基础交互，选依赖属性。控件内部不感知ViewModel的存在，仅通过属性接收数据、触发事件通知外部。
• 若UserControl本身包含部分业务逻辑（比如带表单验证的输入组件，内部需要处理验证逻辑且依赖特定ViewModel方法），可以考虑直接绑定ViewModel，但要注意这种做法会让控件和业务逻辑绑定，降低复用性。

举个Material UI卡片的实际例子：

• 通用卡片组件：定义Title、Subtitle、MediaSource、PrimaryActionCommand等依赖属性，使用方在XAML中绑定各自ViewModel的对应属性即可。
• 页面专属卡片：如果某个页面的卡片样式固定，数据完全来自当前页面ViewModel，也可以直接在UserControl的XAML中绑定{Binding CardData.Title}这类路径，但这种卡片只能在该页面使用。

内容的提问来源于stack exchange，提问作者citelao