WinForms项目中Windows XAML Host控件正确用法及崩溃问题排查

问题背景 #

目标：在WinForms项目的UI中通过XAML Islands实现XAML控件的使用
已导入NuGet包：Microsoft.Toolkit.Forms.UI.XamlHost 5.1.0（因6.x及以上版本存在问题，回退至此版本）
尝试在WinForms设计器添加Xaml Host控件、或通过代码后台创建该控件，均导致UI崩溃。相关代码及配置如下：

后台代码示例 #

public partial class TestForm : Form
{
  public TestForm()
  {
    this.InitializeComponent();
  }

  public void ShowUI()
  {
    WindowsXamlHost windowsXamlHost = new WindowsXamlHost();
    this.Controls.Add(windowsXamlHost);

    Button testButton = new Button();
    testButton.Content = "Test";
           
    windowsXamlHost.Child = testButton;
    this.Show();
    this.BringToFront();
  }
}

app.manifest配置 #

<maxversiontested Id="10.0.18295.0"/>
<supportedOS Id="{8e0f7a12-bfb3-4fe8-b9a5-48fd50a15a9a}" />

调用代码（main.cs） #

TestForm test = new TestForm();
test.ShowUI();

核心问题 #

1. UI崩溃的原因是什么？
2. XAML Host控件的使用方式是否错误？

1. UI崩溃的主要原因 #

• 类型不匹配：代码中创建的Button未指定命名空间，默认是WinForms的System.Windows.Forms.Button，但WindowsXamlHost的Child属性要求的是UWP的Windows.UI.Xaml.Controls.Button，类型冲突直接引发崩溃。
• 系统版本兼容性：你配置的maxversiontested为10.0.18295.0（Windows 10 1809），而Microsoft.Toolkit.Forms.UI.XamlHost 5.1.0要求的最低Windows版本为10.0.17134.0（1803），若系统缺少必要的UWP运行时组件也会导致崩溃。
• 初始化时机问题：在独立的ShowUI方法中动态创建并添加控件，可能WinForms窗体初始化流程未完成，强行注入XAML Islands控件引发线程或资源加载异常。

2. XAML Host控件的使用错误及修正 #

你的代码核心错误是Button类型选择错误，需明确使用UWP控件，同时调整初始化逻辑：

修正后的代码示例 #

using Windows.UI.Xaml.Controls; // 必须添加该命名空间

public partial class TestForm : Form
{
  public TestForm()
  {
    InitializeComponent();
    // 建议在构造函数中完成控件初始化，避免时机问题
    InitializeXamlHost();
  }

  private void InitializeXamlHost()
  {
    var windowsXamlHost = new WindowsXamlHost();
    // 必须设置控件大小，否则会出现布局异常或不显示
    windowsXamlHost.Size = new Size(120, 60);
    windowsXamlHost.Location = new Point(30, 30);
    
    // 明确创建UWP的Button控件
    var uwpButton = new Windows.UI.Xaml.Controls.Button();
    uwpButton.Content = "Test UWP Button";
    uwpButton.Click += (s, e) => MessageBox.Show("UWP按钮被点击！");
    
    windowsXamlHost.Child = uwpButton;
    this.Controls.Add(windowsXamlHost);
  }
}

额外配置检查 #

• 确保app.manifest中补充Windows 10适配配置：

<application xmlns="urn:schemas-microsoft-com:asm.v3">
  <windowsSettings>
    <dpiAware xmlns="http://schemas.microsoft.com/SMI/2005/WindowsSettings">true/PM</dpiAware>
    <dpiAwareness xmlns="http://schemas.microsoft.com/SMI/2016/WindowsSettings">PerMonitorV2, PerMonitor</dpiAwareness>
  </windowsSettings>
</application>

• 确认项目目标框架为.NET Framework 4.6.2及以上（XAML Islands对.NET版本有强制要求）。
• 检查Windows系统版本不低于10.0.17134.0（Windows 10 1803）。

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