WPF自定义标题栏Icon依赖属性绑定失效问题排查求助

你的Icon属性无法显示，核心问题出在依赖属性类型设计错误、绑定路径不匹配，以及ViewModel层违反MVVM原则这三个方面，下面一步步帮你修复：

1. 修正TitleBar的Icon依赖属性类型 #

你当前把Icon依赖属性定义为Image（UI控件类型），但Image控件的Source属性需要的是ImageSource（数据类型，比如BitmapImage），直接传递Image对象不符合WPF的绑定逻辑。

修改TitleBar后台代码：

// 替换原有的Icon属性和依赖属性定义
public ImageSource Icon
{
    get { return (ImageSource)GetValue(IconProperty); }
    set { SetValue(IconProperty, value); }
}

// 重新注册依赖属性，类型改为ImageSource
public static readonly DependencyProperty IconProperty =
    DependencyProperty.Register("Icon", typeof(ImageSource), typeof(TitleBar));

2. 修正XAML中的绑定路径 #

你用了RelativeSource={RelativeSource TemplatedParent}，但这个是针对ControlTemplate模板控件的，而你的TitleBar是普通UserControl，应该绑定到自身的Icon依赖属性：

修改TitleBar的XAML中Image的绑定：

<Image Grid.Column="1" Source="{Binding Icon, RelativeSource={RelativeSource AncestorType=UserControl}}"/>

3. 修正ViewModel的Icon属性（遵循MVVM原则） #

ViewModel层不应该持有UI控件（比如Image），只需要提供数据类型ImageSource即可，同时要实现INotifyPropertyChanged接口保证属性变化能通知UI：

修改MainView_Model代码：

using System.ComponentModel;
using System.Windows.Media;
using System.Windows.Media.Imaging;

namespace Demo_of_WPF_Library.ViewModel
{
    public class MainView_Model : INotifyPropertyChanged
    {
        private string _title;
        public string Title
        {
            get { return _title; }
            set 
            { 
                _title = value;
                OnPropertyChanged(nameof(Title));
            }
        }

        private ImageSource _icon;
        public ImageSource Icon
        {
            get { return _icon; }
            set 
            { 
                _icon = value;
                OnPropertyChanged(nameof(Icon));
            }
        }

        public MainView_Model()
        {
            Title = "Demo WPF Library";
            // 使用Pack URI确保资源能正确加载（根据你的项目结构调整路径）
            Icon = new BitmapImage(new Uri("pack://application:,,,/Demo_of_WPF_Library;component/View/Images/IsItOk.ico"));
        }

        // 实现INotifyPropertyChanged接口，用于属性变更通知
        public event PropertyChangedEventHandler PropertyChanged;
        protected void OnPropertyChanged(string propertyName)
        {
            PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(propertyName));
        }
    }
}

4. （可选但推荐）完善Title属性的封装性 #

虽然你的Title属性能正常工作，但依赖继承自父窗口的DataContext，不够封装。建议也把Title改成依赖属性，让控件更独立：

在TitleBar后台添加Title依赖属性：

public string Title
{
    get { return (string)GetValue(TitleProperty); }
    set { SetValue(TitleProperty, value); }
}

public static readonly DependencyProperty TitleProperty =
    DependencyProperty.Register("Title", typeof(string), typeof(TitleBar));

然后修改TitleBar的TextBlock绑定：

<TextBlock x:Name="Title_Bar" Grid.Column="3" 
           Text="{Binding Title, RelativeSource={RelativeSource AncestorType=UserControl}}" 
           Style="{StaticResource Text_WindowTitle}"/>

主窗口XAML中直接绑定ViewModel的Title：

<uc:TitleBar Name="Titlebar" Icon="{Binding Icon}" Title="{Binding Title}"/>

完成以上修改后，你的Icon应该就能正常显示了。核心思路是：WPF控件的依赖属性应该优先使用数据类型而非UI控件类型，绑定要明确指向控件自身的属性，ViewModel只负责提供数据而非UI元素。

内容的提问来源于stack exchange，提问作者High Plains Grifter