将一个大 XAML 拆分为多个 Sub-XAML 文件

Question

在我的基于 WPF4 桌面的应用程序中，有一个带有侧边栏菜单的大块，该菜单在每个窗口中重复，并且需要大约 70 行 XAML。为了提高代码重用，我想将 XAML 文件拆分为两个文件：

1. 包含侧边栏菜单代码的 XAML 文件（约 70 行）
2. 包含侧边栏菜单代码的 XAML 文件的“包含/引用”的基本 XAML 文件

据我了解，有两种方法可以实现我的问题：

1. 使用 ResourceDictionary
2. 使用 UserControl/CustomControl

我的问题：

1. 有什么区别在 ResourceDictionary 和 UserControl 之间？您能否举例说明我必须使用 UserControl 以及 ResourceDictionary 的情况？

2. 您能否提供一个完整的代码示例，说明如何将一个 XAML 文件的内容包含/导入到另一个 XAML 文件中？

PS 以下是我想要导出到单独的 XAML 文件的代码示例：

<Border Style = "{StaticResource Body_SideBarMenu_Border_Settings}">
    <StackPanel Style = "{StaticResource Body_SideBarMenu}">
        <TextBlock Style = "{StaticResource Body_SideBarMenu_Title}"
                   Text = "{x:Static res:Resources.WinApp_SideBarMenu_Title}" />
        <TextBlock x:Name = "SideBar_WinReports"
                   Style = "{StaticResource Body_SideBarMenu_Item}"
                   Text = "{x:Static res:Resources.DashListMarker}">
            <Hyperlink KeyboardNavigation.TabIndex = "12"
                       Style = "{StaticResource Body_SideBarMenu_Item_Hyperlink}"
                       Click = "Call_WinReports_Click">
                <TextBlock Text = "{x:Static res:Resources.WinApp_ModuleName_Reports}" />
            </Hyperlink>
        </TextBlock>
    </StackPanel>
</Border>

Answer 1

ResourceDictionary 只是样式/模板等的容器。因此，您实际上可以选择使用样式（并通过 ResourceDictionary 引用它）或 UserControl。

为了区分两者，问自己一个问题：您是否正在实现某些现有控件的另一种外观，或者您正在实现一些真正新的东西，这不仅仅是一个 ListView（或一个 Border，或一个 ComboBox 等） ？在前一种情况下，使用样式；在后者中，创建一个新的 UserControl。

针对您的情况，我会选择 UserControl。

---

代码示例（虽然不完整）

（请注意，可以使用 VS 的“添加新用户控件”插入以下代码的模板）

Xaml：

<UserControl x:Class="SomeNamespace.SidebarMenu"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">

    <UserControl.Resources> <!-- you can define local styles here -->
        <Style x:Key="SidebarMenuTextblock" TargetType=TextBlock>
            ...
        </Style>
    </UserControl.Resources>

    <Border Background=...>
        <StackPanel>

            <TextBlock
                x:Name="Put_a_name_if_you_want_to_reference_this_item_in_code_behind"
                Style="{StaticResource SidebarMenuTextblock}"
                Text="{x:Static res:Resources.WinApp_SideBarMenu_Title}" />

            ...

        </StackPanel>
    </Border>

</UserControl>

.cs：

using System;
using System.Windows;
using System.Windows.Controls;

namespace SomeNamespace
{
    public partial class SidebarMenu : UserControl
    {
        public NumericUpDown()
        {
            InitializeComponent();
        }
        ...
        // define here your properties etc,
    }
}

现在，您可以像这样使用控件：

<Window
    x:Class="SomeOtherNamespace.MainWindow"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:controls="clr-namespace:SomeNamespace">

    <Grid>
        <controls:SidebarMenu PropertyIfYouDefinedOne="SomeValue"/>
        ...
    </Grid>

</Window>

Answer 2

如果您可以使用 Expression Studio，在 Expression Blend 中，您只需右键单击任何控件并将其转换为用户控件即可。就这么简单。

用户控件非常适合拆分 XAML 文件。本质上，它用于重新定义现有控件的行为。

但是，使用用户控件，您可以定义整个 WPF 布局控件并将它们转换为用户控件，其中包含子内容。这对于跨多个开发人员的项目非常有帮助，并且还可以用于模拟 MDI 的行为，而这在 WPF 中是不存在的。