.NET Framework 4.8中FolderBrowserDialog跨DPI显示器显示异常问题

核心原因 #

FolderBrowserDialog是基于旧版Win32 Shell的系统对话框，原生不支持PerMonitorV2 DPI感知。当它在不同DPI缩放的显示器间移动时，系统无法实时更新其界面缩放参数，进而导致布局错乱、控件重叠等损坏现象。

推荐解决方案：替换为现代DPI感知对话框 #

最可靠的方式是使用支持PerMonitorV2的现代文件夹选择对话框，.NET Framework 4.8可通过WindowsAPICodePack提供的CommonOpenFileDialog实现：

1. 安装NuGet包
   在项目中安装WindowsAPICodePack-Shell包，这个包提供了对现代Shell对话框的封装。

2. 替换代码实现
   把原有的FolderBrowserDialog调用替换为以下代码：

   using Microsoft.WindowsAPICodePack.Dialogs;
   
   private void YourButton_Click(object sender, EventArgs e)
   {
       var folderDialog = new CommonOpenFileDialog();
       folderDialog.IsFolderPicker = true; // 设置为文件夹选择模式
       folderDialog.Title = "选择文件夹"; // 自定义对话框标题
   
       if (folderDialog.ShowDialog() == CommonFileDialogResult.Ok)
       {
           string selectedFolder = folderDialog.FileName;
           // 后续处理选中的文件夹路径
       }
   }
   

   这个对话框原生支持PerMonitorV2，跨显示器移动时会自动适配目标显示器的DPI缩放，不会出现界面损坏问题。

备选方案：兼容旧对话框（不推荐） #

如果必须保留FolderBrowserDialog，可以通过监听DPI变化事件，在对话框跨显示器时重新打开，但体验较差：

1. 监听窗体DPI变化
   在主窗体中订阅DpiChanged事件，当检测到DPI变化且对话框正在显示时，关闭并重新打开对话框：

   private FolderBrowserDialog _folderDialog;
   
   private void Form1_Load(object sender, EventArgs e)
   {
       _folderDialog = new FolderBrowserDialog();
       this.DpiChanged += Form1_DpiChanged;
   }
   
   private void Form1_DpiChanged(object sender, DpiChangedEventArgs e)
   {
       if (_folderDialog.Visible)
       {
           _folderDialog.Close();
           // 可选择自动重新打开，或提示用户手动重新操作
           _folderDialog.ShowDialog();
       }
   }
   

   这种方式会打断用户的操作流程，仅作为临时兼容方案。

确认DPI感知配置正确性 #

确保app.manifest中的DPI配置完全正确，避免配置冲突：

<application xmlns="urn:schemas-microsoft-com:asm.v3">
  <windowsSettings>
    <!-- 兼容旧系统的DPI感知声明 -->
    <dpiAware xmlns="http://schemas.microsoft.com/SMI/2005/WindowsSettings">True/PM</dpiAware>
    <!-- 优先使用PerMonitorV2 -->
    <dpiAwareness xmlns="http://schemas.microsoft.com/SMI/2016/WindowsSettings">PerMonitorV2, PerMonitor</dpiAwareness>
  </windowsSettings>
</application>

同时确认项目未通过代码（如SetProcessDpiAwarenessContext）覆盖DPI感知设置，避免冲突。

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