在C#的WinForms桌面应用开发中，FolderBrowserDialog是.NET Framework自带的原生文件夹选择对话框控件，能够直接调用系统层级的文件夹浏览界面，让用户直观选择本地磁盘中的文件夹，无需开发者自行实现复杂的文件夹树遍历逻辑。
FolderBrowserDialog核心属性说明
使用前首先需要了解该控件的核心属性，这些属性决定了对话框的显示效果和功能限制：
- Description：对话框顶部显示的提示文本，用于告知用户当前选择文件夹的用途，比如可以设置为"请选择项目存储目录"。
- SelectedPath：获取或设置对话框默认打开的目录路径，如果用户没有选择新路径，该属性会返回设置的默认值。
- ShowNewFolderButton：布尔类型属性，控制对话框中是否显示"新建文件夹"按钮，默认值为true，允许用户创建新文件夹。
- RootFolder：设置对话框的根目录，可选值来自
Environment.SpecialFolder枚举，比如设置为Environment.SpecialFolder.Desktop时，对话框默认从桌面层级开始浏览。
基本使用流程
FolderBrowserDialog的使用流程分为三步：初始化控件实例、设置控件属性、调用ShowDialog方法显示对话框并处理返回结果。
第一步：初始化控件
可以在代码中直接实例化FolderBrowserDialog对象，也可以在WinForms设计器中从工具箱拖入窗体，系统会自动生成对应的实例代码。
第二步：设置属性并显示对话框
通过代码设置控件的各项属性后，调用ShowDialog方法弹出对话框，该方法会返回DialogResult枚举结果，当用户点击"确定"时返回DialogResult.OK，点击"取消"时返回DialogResult.Cancel。
第三步：获取选中路径
当用户确认选择后，通过SelectedPath属性即可获取完整的文件夹路径，后续可以将该路径用于文件读写、项目配置等场景。
完整代码示例
以下是一个按钮点击触发文件夹选择功能的完整示例代码，包含属性设置和结果处理逻辑：
using System;
using System.Windows.Forms;
namespace FolderBrowserDemo
{
public partial class MainForm : Form
{
public MainForm()
{
InitializeComponent();
}
private void btnSelectFolder_Click(object sender, EventArgs e)
{
// 实例化FolderBrowserDialog对象
using (FolderBrowserDialog folderDialog = new FolderBrowserDialog())
{
// 设置对话框顶部提示文本
folderDialog.Description = "请选择需要处理的文件夹";
// 设置默认打开路径为桌面
folderDialog.SelectedPath = Environment.GetFolderPath(Environment.SpecialFolder.Desktop);
// 允许用户在对话框中新建文件夹
folderDialog.ShowNewFolderButton = true;
// 设置根目录为桌面
folderDialog.RootFolder = Environment.SpecialFolder.Desktop;
// 显示对话框并判断用户操作
if (folderDialog.ShowDialog() == DialogResult.OK)
{
// 获取用户选择的文件夹路径
string selectedFolderPath = folderDialog.SelectedPath;
// 将路径显示在文本框中
txtFolderPath.Text = selectedFolderPath;
MessageBox.Show($"成功选择文件夹：{selectedFolderPath}");
}
else
{
MessageBox.Show("用户取消了文件夹选择操作");
}
}
}
}
}
使用注意事项
在实际开发中使用FolderBrowserDialog时，需要注意以下几点问题：
- FolderBrowserDialog属于WinForms控件，WPF应用中无法直接使用该控件，WPF中需要使用
System.Windows.Forms.FolderBrowserDialog并添加对应的程序集引用，或者使用其他第三方文件夹选择控件。 - 如果用户没有选择新路径就点击确定，SelectedPath属性会返回之前设置的SelectedPath默认值，因此如果需要判断用户是否选择了新路径，可以在调用ShowDialog之前先保存默认路径，之后对比两次路径是否一致。
- 获取到的路径末尾默认不包含路径分隔符，如果需要拼接子文件路径，建议先使用
Path.Combine方法处理，避免手动拼接导致的路径格式错误。
注意：FolderBrowserDialog的界面样式依赖系统版本，不同Windows系统下显示的对话框样式可能存在细微差异，但核心功能保持一致。
C#FolderBrowserDialogWinForms文件夹选择对话框修改时间：2026-06-22 11:06:54