C#-OpenFileDialog

OpenFileDialog 是 C# 中常用的对话框控件，用于让用户选择文件。下面是对其中的几个常用属性进行解释：

• Title：设置对话框的标题文字。
• Multiselect：设置是否允许选择多个文件，默认值为 false。若设置为 true，则可以按住 Ctrl 或 Shift 键，同时选择多个文件。
• Filter：设置可以选择的文件类型，格式为 “描述文字|文件类型”，多个类型之间用竖线 | 隔开。若不设置，则默认所有文件都可以选择。下面是一个示例：

openFileDialog1.Filter = "文本文件|*.txt|Word文档|*.doc|所有文件|*.*";

除了上面提到的属性，OpenFileDialog 还有一些常用的方法，下面是其中几个：

• ShowDialog()：显示打开文件的对话框，并返回对话框结果。如果用户选择了文件，对话框结果为 true；如果用户取消选择，对话框结果为 false。
• FileNames：获取用户选择的文件名，如果 Multiselect 属性为 true，则返回一个字符串数组；否则返回一个长度为 1 的字符串数组。
• FileName：获取用户选择的第一个文件名，等同于 FileNames[0]。

示例代码：

OpenFileDialog openFileDialog1 = new OpenFileDialog();
openFileDialog1.Title = "选择一个文件";
openFileDialog1.Multiselect = true;
openFileDialog1.Filter = "文本文件|*.txt|所有文件|*.*";
if (openFileDialog1.ShowDialog() == DialogResult.OK)
{
    foreach (string fileName in openFileDialog1.FileNames)
    {
        Console.WriteLine("已选择文件：" + fileName);
    }
}

这段代码使用 OpenFileDialog 对话框来选择一个或多个文件。

1. 首先创建一个 OpenFileDialog 对象 openFileDialog1。
2. 设置对话框的标题、是否允许多选、文件类型筛选器等属性。
3. 调用 ShowDialog() 方法，打开对话框并等待用户的操作。如果用户按下了“确定”按钮，就执行下面的代码。
4. 在选择文件的情况下，遍历 FileNames 属性，其中包含了用户选择的所有文件的完整路径。

foreach (string fileName in openFileDialog1.FileNames)
{
    Console.WriteLine("已选择文件：" + fileName);
}

5. 在上面的示例代码中，Multiselect 属性被设置为 true，因此用户可以选择多个文件。在遍历 FileNames 属性时，我们可以得到每个文件的完整路径，并将其输出到控制台中。

---

public static List<string> GetOpenFilesPath(string title, bool canBeMultiple = false, string filter = "")
{
    List<string> list = new List<string>();
    OpenFileDialog dialog = new OpenFileDialog {
        Title = title,
        Multiselect = canBeMultiple,
        Filter = string.IsNullOrEmpty(filter) ? "所有文件(*.*)|*.*" : filter
    };
    if (dialog.ShowDialog().Value)
    {
        list.Add(dialog.FileName);
    }
    return list;
}

这段代码的作用是打开文件对话框，让用户选择一个或多个文件，然后返回选择的文件路径列表。

1. title：文件对话框的标题，通常是一个字符串，用于提示用户当前选择文件的用途
2. canBeMultiple：一个布尔值，表示是否允许选择多个文件。如果该值为 true，则文件对话框会显示“多选”按钮，用户可以同时选择多个文件；否则，文件对话框只会显示“打开”按钮，用户只能选择一个文件。
3. filter：一个字符串，表示文件对话框中可以显示的文件类型。该字符串的格式通常为“类型名称（.扩展名）|.扩展名”（多个类型用竖线符号 | 分隔），例如“文本文件(.txt)|.txt|所有文件(.)|.”。如果该参数为空字符串或 null，则默认显示所有文件类型。

---

该方法的返回值为一个字符串列表，表示用户选择的文件的完整路径。如果用户没有选择任何文件，则返回一个空列表。

举例说明，假设你想让用户选择一个或多个图片文件，并且只显示 .png 和 .jpg 文件类型，那么可以执行以下代码：

List<string> imagePathList = GetOpenFilesPath("选择图片文件", true, "PNG 文件(*.png)|*.png|JPG 文件(*.jpg)|*.jpg");

将会打开一个文件对话框，标题为“选择图片文件”，可以选择多个文件，只显示 .png 和 .jpg 文件类型。用户选择的文件路径会保存在 imagePathList 列表中，你可以对该列表进行遍历、处理等操作。