C# WPF中如何动态修改用户控件内按钮的图标

要实现从外部视图动态给SearchItems控件的按钮设置Path图标数据，核心是正确定义依赖属性并完成XAML绑定，以下是分步实现方案：

1. 在SearchItems后台定义PathGeometry类型的依赖属性 #

依赖属性的类型必须和资源中的数据类型一致（这里是PathGeometry，而非字符串），确保属性能正确接收外部传入的几何数据：

public partial class SearchItems : UserControl
{
    // 注册依赖属性，名称要和属性名匹配
    public static readonly DependencyProperty IconDataProperty =
        DependencyProperty.Register(
            nameof(IconData),
            typeof(PathGeometry),
            typeof(SearchItems),
            new PropertyMetadata(null));

    // 包装属性
    public PathGeometry IconData
    {
        get => (PathGeometry)GetValue(IconDataProperty);
        set => SetValue(IconDataProperty, value);
    }

    public SearchItems()
    {
        InitializeComponent();
    }
}

2. 修改SearchItems的XAML，绑定Path的Data到依赖属性 #

需要通过RelativeSource指定绑定的来源是当前UserControl，避免因DataContext继承导致的绑定错误：

<!--  Add new Item Button  -->
<Button
    x:Name="createButton"
    Width="40"
    Height="40"
    Margin="0,0,20,0"
    HorizontalAlignment="Right"
    VerticalAlignment="Center"
    Command="{Binding OpenNewWindowCommand}"
    Style="{StaticResource RoundAccentButton}">
    <!--  Icon  -->
    <Viewbox
        x:Name="createViewbox"
        Width="22"
        Height="22">
        <Path 
            Data="{Binding IconData, RelativeSource={RelativeSource AncestorType=UserControl}}" 
            Fill="{StaticResource OnAccent}" />
    </Viewbox>
</Button>

3. 在外部视图（如TaskView）中设置属性 #

现在可以直接在使用SearchItems的地方，通过静态资源或其他方式传入几何数据：

<uc:SearchItems IconData="{StaticResource NewTaskIcon}" />

常见错误排查 #

• 类型不匹配：如果之前用string类型定义依赖属性，会无法正确接收PathGeometry资源，必须保持类型一致。
• 绑定来源错误：未指定RelativeSource时，Path会继承按钮的DataContext，导致找不到UserControl的属性。
• 依赖属性注册名称错误：注册依赖属性时的第一个参数必须和包装属性名完全一致，否则绑定失效。

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