当前位置：首页 > article >正文

详解C#调用系统文件窗口：打开文件、保存文件和选择文件夹

article 2025/1/14 9:40:34

详解C#调用系统文件窗口：打开文件、保存文件和选择文件夹

在C#开发中，调用系统文件窗口是一个常见的需求。无论是让用户选择文件、保存文件，还是选择文件夹，系统文件窗口都能提供直观的用户体验。本文将详细介绍如何在C#中使用OpenFileDialog、SaveFileDialog和FolderBrowserDialog（或CommonOpenFileDialog）来实现这些功能。

1. 使用 `OpenFileDialog` 打开文件

OpenFileDialog 是一个用于选择文件的系统对话框。它允许用户浏览文件系统并选择一个或多个文件。

1.1 基本用法

以下是一个简单的示例，展示如何使用OpenFileDialog选择文件并获取文件路径：

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属性获取所有选择的文件路径。

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保存文件：

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选择文件夹：

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：

Install-Package Microsoft.WindowsAPICodePack-Shell

4.2 使用 `CommonOpenFileDialog`

以下是一个示例，展示如何使用 CommonOpenFileDialog 选择文件夹：

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);
        }
    }
}