详解C#调用系统文件窗口：打开文件、保存文件和选择文件夹
在C#开发中，调用系统文件窗口是一个常见的需求。无论是让用户选择文件、保存文件，还是选择文件夹，系统文件窗口都能提供直观的用户体验。本文将详细介绍如何在C#中使用OpenFileDialog、SaveFileDialog和FolderBrowserDialog（或CommonOpenFileDialog）来实现这些功能。
1. 使用 OpenFileDialog 打开文件
OpenFileDialog 是一个用于选择文件的系统对话框。它允许用户浏览文件系统并选择一个或多个文件。
1.1 基本用法
以下是一个简单的示例，展示如何使用OpenFileDialog选择文件并获取文件路径：
csharp
using System;
using System.Windows.Forms;
class Program
{
[STAThread] // 必须标记为单线程
static void Main()
{
// 创建 OpenFileDialog 对象
OpenFileDialog openFileDialog = new OpenFileDialog();
// 设置对话框标题
openFileDialog.Title = "请选择一个文件";
// 设置文件过滤器
openFileDialog.Filter = "文本文件 (*.txt)|*.txt|所有文件 (*.*)|*.*";
// 显示对话框并检查用户是否点击了"确定"
if (openFileDialog.ShowDialog() == DialogResult.OK)
{
// 获取用户选择的文件路径
string filePath = openFileDialog.FileName;
Console.WriteLine("选择的文件路径: " + filePath);
}
}
}关键属性：
- Title：设置对话框的标题。
- Filter ：设置文件类型过滤器。格式为
"描述|扩展名"，多个过滤器用|分隔。 - FileName：获取用户选择的文件路径。
- Multiselect ：设置为
true时，允许用户选择多个文件。
1.2 选择多个文件
如果希望用户可以选择多个文件，可以将Multiselect属性设置为true，并通过FileNames属性获取所有选择的文件路径。
csharp
openFileDialog.Multiselect = true;
if (openFileDialog.ShowDialog() == DialogResult.OK)
{
string[] filePaths = openFileDialog.FileNames;
foreach (string filePath in filePaths)
{
Console.WriteLine("选择的文件路径: " + filePath);
}
}2. 使用 SaveFileDialog 保存文件
SaveFileDialog 是一个用于保存文件的系统对话框。它允许用户选择保存文件的路径和文件名。
2.1 基本用法
以下是一个简单的示例，展示如何使用SaveFileDialog保存文件：
csharp
using System;
using System.Windows.Forms;
class Program
{
[STAThread]
static void Main()
{
// 创建 SaveFileDialog 对象
SaveFileDialog saveFileDialog = new SaveFileDialog();
// 设置对话框标题
saveFileDialog.Title = "保存文件";
// 设置文件过滤器
saveFileDialog.Filter = "文本文件 (*.txt)|*.txt|所有文件 (*.*)|*.*";
// 显示对话框并检查用户是否点击了"保存"
if (saveFileDialog.ShowDialog() == DialogResult.OK)
{
// 获取用户选择的保存路径
string filePath = saveFileDialog.FileName;
// 写入文件内容
string content = "这是保存的文件内容！";
System.IO.File.WriteAllText(filePath, content);
Console.WriteLine("文件已保存到: " + filePath);
}
}
}关键属性：
- Title：设置对话框的标题。
- Filter：设置文件类型过滤器。
- FileName：获取或设置默认的文件名。
- OverwritePrompt ：设置为
true时，如果文件已存在，会提示用户是否覆盖。
3. 使用 FolderBrowserDialog 选择文件夹
FolderBrowserDialog 是一个用于选择文件夹的系统对话框。它允许用户浏览文件系统并选择一个文件夹。
3.1 基本用法
以下是一个简单的示例，展示如何使用FolderBrowserDialog选择文件夹：
csharp
using System;
using System.Windows.Forms;
class Program
{
[STAThread]
static void Main()
{
// 创建 FolderBrowserDialog 对象
FolderBrowserDialog folderBrowserDialog = new FolderBrowserDialog();
// 设置对话框标题
folderBrowserDialog.Description = "请选择一个文件夹";
// 显示对话框并检查用户是否点击了"确定"
if (folderBrowserDialog.ShowDialog() == DialogResult.OK)
{
// 获取用户选择的文件夹路径
string folderPath = folderBrowserDialog.SelectedPath;
Console.WriteLine("选择的文件夹路径: " + folderPath);
}
}
}关键属性：
- Description：设置对话框的描述文本。
- SelectedPath：获取用户选择的文件夹路径。
- ShowNewFolderButton ：设置为
true时，允许用户创建新文件夹。
4. 使用 CommonOpenFileDialog 选择文件夹（Windows API Code Pack）
FolderBrowserDialog 的功能较为简单，如果需要更强大的文件夹选择功能（如支持多选、显示更多文件信息），可以使用 Windows API Code Pack 中的 CommonOpenFileDialog。
4.1 安装 Windows API Code Pack
首先，需要通过 NuGet 安装 Windows API Code Pack：
bash
Install-Package Microsoft.WindowsAPICodePack-Shell4.2 使用 CommonOpenFileDialog
以下是一个示例，展示如何使用 CommonOpenFileDialog 选择文件夹：
csharp
using System;
using Microsoft.WindowsAPICodePack.Dialogs;
class Program
{
[STAThread]
static void Main()
{
// 创建 CommonOpenFileDialog 对象
CommonOpenFileDialog dialog = new CommonOpenFileDialog();
// 设置对话框标题
dialog.Title = "请选择一个文件夹";
// 设置为文件夹选择模式
dialog.IsFolderPicker = true;
// 显示对话框并检查用户是否点击了"确定"
if (dialog.ShowDialog() == CommonFileDialogResult.Ok)
{
// 获取用户选择的文件夹路径
string folderPath = dialog.FileName;
Console.WriteLine("选择的文件夹路径: " + folderPath);
}
}
}关键属性：
- IsFolderPicker ：设置为
true时，对话框用于选择文件夹。 - Multiselect ：设置为
true时，允许用户选择多个文件夹。
5. 总结
通过 OpenFileDialog、SaveFileDialog 和 FolderBrowserDialog（或 CommonOpenFileDialog），我们可以轻松实现文件选择、保存和文件夹选择的功能。这些系统文件窗口不仅提供了良好的用户体验，还能简化开发工作。
如果你有任何问题或建议，欢迎在评论区留言！