如何让WPF自定义控件的自定义属性显示在XAML设计器属性窗口

要让自定义属性出现在XAML设计器的属性窗口中，核心是把普通CLR属性包装成WPF依赖属性，同时可添加特性优化显示效果，具体步骤如下：

1. 将CLR属性转换为依赖属性 #

WPF设计器仅识别注册为依赖属性的成员，而非普通公共CLR属性。以你的BitmapSource属性为例，替换原有属性定义为依赖属性：

public static readonly DependencyProperty ImageSourceProperty =
    DependencyProperty.Register(
        nameof(ImageSource),
        typeof(BitmapSource),
        typeof(YourUserControlName),
        new PropertyMetadata(null)); // 可按需设置默认值或属性变更回调

public BitmapSource ImageSource
{
    get => (BitmapSource)GetValue(ImageSourceProperty);
    set => SetValue(ImageSourceProperty, value);
}

注意替换YourUserControlName为你的自定义UserControl类名，ImageSource可根据需求修改为你的属性名。

2. 添加特性优化属性窗口显示 #

如果希望属性在窗口中分类显示、带有描述，可添加CategoryAttribute和DescriptionAttribute：

using System.ComponentModel;

[Category("自定义属性")]
[Description("用于显示的位图资源")]
public BitmapSource ImageSource
{
    get => (BitmapSource)GetValue(ImageSourceProperty);
    set => SetValue(ImageSourceProperty, value);
}

这样属性会被归类到“自定义属性”分组下，并显示描述文本，更贴合设计器使用习惯。

3. 验证设计时支持 #

完成修改后重新生成项目，将UserControl拖拽到XAML中，即可在属性窗口找到你定义的ImageSource属性，支持直接在设计器中设置（比如选择项目内的图片资源），无需依赖后台代码赋值。

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