Разделить один большой XAML в количестве файлов Sub-XAML

В моем рабочем приложении WPF4 Desktop есть большой блок с меню боковой панели, который повторяется в каждом окне и занимает около 70 строк XAML. Чтобы улучшить повторное использование кода, я хотел бы разбить файл XAML в двух файлах:

  • XAML файл, содержащий код для меню боковой панели (≈70 строк)
  • Базовый XAML файл, содержащий "include/reference" для XAML файла с кодом меню боковой панели

Как я понял, есть два способа реализовать мою проблему:

  • Использовать ResourceDictionary
  • Использовать UserControl/CustomControl

Мои вопросы:

  • В чем разница между ResourceDictionary и UserControl? Не могли бы вы привести примеры, где я должен использовать UserControl и где ResourceDictionary?

  • Не могли бы вы привести полный пример кода, как включить/импортировать содержимое одного XAML файла в другой?

P.S. Вот пример кода, который я хочу экспортировать в отдельный файл 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>

Ответы

Ответ 1

ResourceDictionary - это просто контейнер для ваших стилей/шаблонов и т.д. Таким образом, у вас действительно есть выбор между использованием стиля (и ссылкой на него через ResourceDictionary) или UserControl.

Чтобы различать эти два вопроса, задайте себе вопрос: реализуете ли вы просто другой взгляд на какой-то существующий элемент управления или реализуете что-то действительно новое, что больше, чем просто ListView (или Border или ComboBox и т.д.)? В первом случае используйте стиль; в последнем, создайте новый UserControl.

В частности, для вашего случая я бы пошел на UserControl.

Пример кода (хотя и не полный)

(Обратите внимание, что шаблон для следующего кода может быть вставлен с VS "добавить новый UserControl" )

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>

Ответ 2

Если вы можете получить доступ к Expression Studio, в Expression Blend, вы можете просто щелкнуть правой кнопкой мыши по любому элементу управления и преобразовать его в пользовательский элемент управления. Так просто.

Пользовательские элементы управления хороши для разделения файла XAML. По сути, он используется для переопределения поведения существующего элемента управления.

Однако с помощью элементов управления пользователя вы можете определить все элементы управления макетами WPF и преобразовать их в пользовательский элемент управления с содержимым детей внутри них. Это очень полезно для проекта, распространяемого несколькими разработчиками, а также может использоваться для эмуляции поведения MDI, который отсутствует в WPF.