如何通过自定义控件去除重复XAML代码？多文件重复XAML消除方案咨询

嘿，针对你提出的两个XAML代码复用问题，我给你整理了实用的解决方案，都是日常开发中常用的套路：

1. 用自定义控件移除重复的XAML代码 #

从你的示例代码来看，你重复使用了StackPanel+NewLabel+ETextBox的组合布局，这种带固定交互逻辑或结构的重复代码，最适合用自定义UserControl来封装，步骤如下：

第一步：创建封装好的UserControl #

先新建一个LabeledTextBox.xaml，把重复的布局结构放进去：

<!-- LabeledTextBox.xaml -->
<UserControl x:Class="YourApp.Controls.LabeledTextBox"
             xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
             xmlns:ctl="clr-namespace:YourApp.Controls">
    <StackPanel Style="{StaticResource ViewContentStyle}">
        <ctl:NewLabel x:Name="TitleLabel"
                      LabelStyle="{DynamicResource ContentLabelStyle}"
                      ImageStyle="{DynamicResource ViewContentControlStyle}"/>
        <ctl:ETextBox x:Name="InputBox"
                      HorizontalAlignment="Left"/>
    </StackPanel>
</UserControl>

第二步：添加依赖属性实现数据绑定 #

在后台代码中，把需要外部绑定的属性（比如标签文本、输入框内容、可见性）定义为依赖属性，让自定义控件能和外部ViewModel交互：

// LabeledTextBox.xaml.cs
public partial class LabeledTextBox : UserControl
{
    // 标签文本的依赖属性
    public static readonly DependencyProperty LabelContentProperty =
        DependencyProperty.Register(nameof(LabelContent), typeof(object), typeof(LabeledTextBox), new PropertyMetadata(null));
    
    // 输入框内容的依赖属性（双向绑定）
    public static readonly DependencyProperty InputTextProperty =
        DependencyProperty.Register(nameof(InputText), typeof(string), typeof(LabeledTextBox), new PropertyMetadata(string.Empty, FrameworkPropertyMetadataOptions.BindsTwoWayByDefault));
    
    // 控件可见性的依赖属性
    public static readonly DependencyProperty ControlVisibilityProperty =
        DependencyProperty.Register(nameof(ControlVisibility), typeof(Visibility), typeof(LabeledTextBox), new PropertyMetadata(Visibility.Visible));

    public object LabelContent
    {
        get => GetValue(LabelContentProperty);
        set => SetValue(LabelContentProperty, value);
    }

    public string InputText
    {
        get => (string)GetValue(InputTextProperty);
        set => SetValue(InputTextProperty, value);
    }

    public Visibility ControlVisibility
    {
        get => (Visibility)GetValue(ControlVisibilityProperty);
        set => SetValue(ControlVisibilityProperty, value);
    }

    public LabeledTextBox()
    {
        InitializeComponent();
        // 把内部控件的属性绑定到自定义控件的依赖属性
        TitleLabel.SetBinding(ctl.NewLabel.LabelContentProperty, new Binding(nameof(LabelContent)) { Source = this });
        InputBox.SetBinding(ctl.ETextBox.TextProperty, new Binding(nameof(InputText)) { Source = this });
        this.SetBinding(VisibilityProperty, new Binding(nameof(ControlVisibility)) { Source = this });
    }
}

第三步：简化调用代码 #

现在你可以在任何需要的地方，用一行代码替代原来的多行重复XAML：

<ctl:LabeledTextBox Grid.Row="8" Grid.Column="2"
                    LabelContent="{x:Static common:LocalResources.UNameLabel}"
                    ControlVisibility="{Binding Type, Converter={StaticResource TypeToVisibility}}"
                    InputText="{Binding UserName}"/>

如果你的重复控件需要高度自定义样式，可以改用CustomControl（继承自Control），通过ControlTemplate来实现样式的灵活替换，不过UserControl已经能解决大部分场景。

2. 消除不同文件中的重复XAML代码 #

如果重复代码分散在多个XAML文件中，除了自定义控件，还有以下几种高效方案：

方案一：用资源字典复用样式/模板 #

如果重复的是样式、DataTemplate或ControlTemplate，把它们放到全局资源字典（比如App.xaml或单独的SharedResources.xaml）中，所有文件都能引用：

<!-- SharedResources.xaml -->
<ResourceDictionary xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
                    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
                    xmlns:ctl="clr-namespace:YourApp.Controls">
    <!-- 复用的StackPanel样式 -->
    <Style x:Key="ViewContentStackPanelStyle" TargetType="StackPanel">
        <Setter Property="Margin" Value="0 8 0 0"/>
        <Setter Property="Style" Value="{StaticResource ViewContentStyle}"/>
    </Style>

    <!-- 复用的NewLabel样式 -->
    <Style x:Key="ContentLabelDefaultStyle" TargetType="ctl:NewLabel">
        <Setter Property="LabelStyle" Value="{DynamicResource ContentLabelStyle}"/>
        <Setter Property="ImageStyle" Value="{DynamicResource ViewContentControlStyle}"/>
    </Style>
</ResourceDictionary>

在需要的XAML文件中引用这个资源字典：

<UserControl.Resources>
    <ResourceDictionary>
        <ResourceDictionary.MergedDictionaries>
            <ResourceDictionary Source="SharedResources.xaml"/>
        </ResourceDictionary.MergedDictionaries>
    </ResourceDictionary>
</UserControl.Resources>

之后就能直接应用样式，减少重复代码：

<StackPanel Grid.Row="8" Grid.Column="2" 
            Style="{StaticResource ViewContentStackPanelStyle}"
            Visibility="{Binding Type, Converter={StaticResource TypeToVisibility}}">
    <ctl:NewLabel LabelContent="{x:Static common:LocalResources.UNameLabel}"
                  Style="{StaticResource ContentLabelDefaultStyle}">
        <ctl:ETextBox x:Name="UserName" HorizontalAlignment="Left"/>
    </ctl:NewLabel>
</StackPanel>

方案二：用XAML片段包含（WPF 4.5+支持） #

如果是小范围的重复布局片段，可以把它单独放到一个XAML文件中，然后在其他文件中直接引用：

<!-- CommonInputLayout.xaml -->
<StackPanel x:Class="YourApp.Common.CommonInputLayout"
            xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
            xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
            Style="{StaticResource ViewContentStyle}">
    <ctl:NewLabel x:Name="LayoutLabel"
                  LabelStyle="{DynamicResource ContentLabelStyle}"
                  ImageStyle="{DynamicResource ViewContentControlStyle}"/>
    <!-- 留空的ContentPresenter，用于插入不同的输入控件 -->
    <ContentPresenter x:Name="InputPresenter"/>
</StackPanel>

在其他文件中引用时，直接插入需要的输入控件：

<common:CommonInputLayout Grid.Row="8" Grid.Column="2"
                          Visibility="{Binding Type, Converter={StaticResource TypeToVisibility}}"
                          LayoutLabel.LabelContent="{x:Static common:LocalResources.UNameLabel}">
    <common:CommonInputLayout.InputPresenter>
        <ctl:ETextBox x:Name="UserName" HorizontalAlignment="Left"/>
    </common:CommonInputLayout.InputPresenter>
</common:CommonInputLayout>

方案三：用ContentControl+DataTemplate统一布局 #

如果你的重复布局是针对不同数据类型的展示，可以定义统一的DataTemplate，用ContentControl来承载，通过数据驱动UI，避免重复写布局。

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