PAYATHON 2026

WPF 使用 .NET 4.8 时,如何通过按钮切换两个 XAML 界面?

数据小许

可以将两个界面分别做成 UserControl,在主窗口中放置一个 ContentControl,通过按钮修改它的 Content 来切换界面。这个方案适用于 .NET Framework 4.8,也适合界面较少、暂时不需要前进和后退导航的应用。

先确认两个 XAML 文件的类型

XAML 是界面的定义文件,切换方式取决于它的根元素:

  • UserControl:适合放进主窗口的内容区域,通过 ContentControl 切换。
  • Page:适合放进 Frame,使用导航功能切换。
  • Window:代表独立窗口,使用 Show() 等方法打开。如果希望在同一个窗口内切换内容,可以把界面内容移到 UserControl 中。

原问题没有说明现有文件的根元素,下面以两个 UserControl 为例,演示按钮切换逻辑。

创建两个 UserControl

在项目中添加两个 WPF 用户控件,命名为 FirstView 和 SecondView。示例使用 ScreenSwitchDemo 命名空间,请替换成项目的实际命名空间。

FirstView.xaml:

<UserControl x:Class="ScreenSwitchDemo.FirstView"
             xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">
    <StackPanel Margin="20">
        <TextBlock Text="第一个界面" FontSize="24" />
        <TextBox Margin="0,12,0,0" Width="240"
                 HorizontalAlignment="Left" />
    </StackPanel>
</UserControl>

FirstView.xaml.cs:

using System.Windows.Controls;

namespace ScreenSwitchDemo
{
    public partial class FirstView : UserControl
    {
        public FirstView()
        {
            InitializeComponent();
        }
    }
}

SecondView.xaml:

<UserControl x:Class="ScreenSwitchDemo.SecondView"
             xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">
    <Grid Margin="20">
        <TextBlock Text="第二个界面" FontSize="24" />
    </Grid>
</UserControl>

SecondView.xaml.cs:

using System.Windows.Controls;

namespace ScreenSwitchDemo
{
    public partial class SecondView : UserControl
    {
        public SecondView()
        {
            InitializeComponent();
        }
    }
}

如果现有文件已经是 UserControl,可以直接使用。如果是 Window,建议新建用户控件,再迁移其中的布局和事件代码。Title、Show()、Close() 等窗口专用属性和操作需要单独调整。

在主窗口中放置按钮和内容容器

MainWindow.xaml:

<Window x:Class="ScreenSwitchDemo.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        Title="界面切换示例" Height="350" Width="600">
    <Grid>
        <Grid.RowDefinitions>
            <RowDefinition Height="Auto" />
            <RowDefinition Height="*" />
        </Grid.RowDefinitions>

        <StackPanel Orientation="Horizontal" Margin="10">
            <Button Content="界面一" Padding="12,6"
                    Click="ShowFirstView_Click" />
            <Button Content="界面二" Padding="12,6" Margin="8,0,0,0"
                    Click="ShowSecondView_Click" />
        </StackPanel>

        <ContentControl x:Name="ViewHost" Grid.Row="1"
                        HorizontalContentAlignment="Stretch"
                        VerticalContentAlignment="Stretch" />
    </Grid>
</Window>

MainWindow.xaml.cs:

using System.Windows;

namespace ScreenSwitchDemo
{
    public partial class MainWindow : Window
    {
        private readonly FirstView firstView = new FirstView();
        private readonly SecondView secondView = new SecondView();

        public MainWindow()
        {
            InitializeComponent();
            ViewHost.Content = firstView;
        }

        private void ShowFirstView_Click(object sender, RoutedEventArgs e)
        {
            ViewHost.Content = firstView;
        }

        private void ShowSecondView_Click(object sender, RoutedEventArgs e)
        {
            ViewHost.Content = secondView;
        }
    }
}

这行赋值负责切换界面:

ViewHost.Content = secondView;

ContentControl 会显示传入的控件实例。控件的 XAML 和对应的代码文件仍按各自的职责工作,无需手动读取或替换 XAML 文件。

切换时是否保留界面状态?

示例中的两个界面只创建一次,后续切换时复用同一组实例。因此,只要没有其他代码或数据绑定重置输入,第一个界面中的文本通常会保留。

如果每次点击都重新创建界面:

ViewHost.Content = new FirstView();

每次得到的都是新实例,控件自身保存的输入状态不会自动延续。需要持久保存的数据应放到独立的数据对象或 ViewModel 中。

复用实例时还要注意:控件重新加入可视树后,Loaded 可能再次触发,不宜在其中无条件重复订阅事件或重置用户输入。

什么时候选择 Frame 和 Page?

如果两个界面已经是 Page,或者需要前进、后退等导航行为,可以在主窗口中使用 Frame:

<Frame x:Name="MainFrame" NavigationUIVisibility="Hidden" />

在按钮事件中导航到相应的 Page 实例,例如:

MainFrame.Navigate(new FirstPage());

这里的 FirstPage 必须是项目中已定义的 Page。隐藏导航栏不会自动禁用导航历史;页面状态和历史记录需要按实际需求处理。

对于目前两个界面之间的简单切换,使用 UserControl 和 ContentControl 即可。后续界面数量和业务状态增加时,可以考虑通过 MVVM、数据绑定和 DataTemplate 管理当前显示的视图。

备注:内容仅供参考。