C#WinForm 文件对话框（OpenFileDialog / FolderBrowserDialog）+ 对象本地存储（自定义类读写文件）

文件对话框（OpenFileDialog / FolderBrowserDialog）

一、知识点概述

1、文件对话框属于WinForm自带交互控件，无需手动拖拽，可代码直接实例化调用。

2、OpenFileDialog：文件打开对话框，用于选择本地文件，支持筛选文件类型、设置初始路径，可读取选中文件内容。

3、FolderBrowserDialog：文件夹浏览对话框，专门用于选择本地文件夹，只能获取文件夹路径，不能选择文件。

4、核心逻辑：弹出对话框 → 用户选择路径 → 判断确认状态 → 获取选中路径执行业务操作。

二、完整源代码

using System;
using System.IO;
using System.Text;
using System.Windows.Forms;

namespace _1文件对话框
{
    public partial class Form1 : Form
    {
        public Form1()
        {
            InitializeComponent();
        }

        private void button1_Click(object sender, EventArgs e)
        {
            #region 【1.文件打开对话框（注释代码）】
            ////1.实例化文件打开对话框对象
            //OpenFileDialog ofd = new OpenFileDialog();

            ////2.设置对话框初始打开路径
            //ofd.InitialDirectory = @"D:\";

            ////3.设置对话框标题
            //ofd.Title = "打开文件";

            ////4.设置文件类型过滤（只显示指定格式文件）
            //ofd.Filter = "文本文件|*.txt|图片|*.jpg";

            ////5.弹出对话框，接收用户操作结果
            //DialogResult result = ofd.ShowDialog();

            ////6.判断用户点击【确定】，读取选中文件内容
            //if (result == DialogResult.OK)
            //{
            //    //FileName：获取选中文件的完整绝对路径
            //    this.Text = File.ReadAllText(ofd.FileName, Encoding.Default);
            //}
            #endregion

            #region 【2.文件夹浏览对话框（运行代码）】
            //1.实例化文件夹选择对话框
            FolderBrowserDialog folderBrowserDialog = new FolderBrowserDialog();

            //2.设置对话框提示描述文字
            folderBrowserDialog.Description = "选择一个文件夹";

            //3.设置对话框根目录（默认打开公共文档目录）
            folderBrowserDialog.RootFolder = Environment.SpecialFolder.CommonDocuments;

            //4.弹出文件夹选择框，判断用户是否点击确定
            if (folderBrowserDialog.ShowDialog() == DialogResult.OK)
            {
                //SelectedPath：获取用户选中的文件夹完整路径
                Console.WriteLine(folderBrowserDialog.SelectedPath);
                //将选中路径赋值给窗体标题
                this.Text = folderBrowserDialog.SelectedPath;
            }
            #endregion
        }
    }
}

三、第一模块：OpenFileDialog 文件打开对话框（分段拆解）

1、实例化对话框对象

OpenFileDialog ofd = new OpenFileDialog();

创建文件选择对话框实例，用于后续配置属性、弹出窗口、选择文件。

2、InitialDirectory 初始路径

ofd.InitialDirectory = @"D:\";

设置对话框默认打开的文件夹路径，程序启动弹窗直接定位到指定目录。

3、Title 对话框标题

ofd.Title = "打开文件";

自定义弹出窗口的顶部标题文字，提升界面友好度。

4、Filter 文件类型过滤（重点）

ofd.Filter = "文本文件|*.txt|图片|*.jpg";

作用：筛选可选择的文件类型，隐藏其他格式文件。

格式规则：说明文字|后缀规则|说明文字|后缀规则

示例解析：只展示txt文本文件和jpg图片文件。

5、ShowDialog() 弹出窗口

DialogResult result = ofd.ShowDialog();

弹出模态文件选择窗口，阻塞当前程序，等待用户操作，返回操作结果枚举。

6、判断用户操作 + 读取文件

if (result == DialogResult.OK)
{
    this.Text = File.ReadAllText(ofd.FileName,Encoding.Default);
}

DialogResult.OK：用户选中文件并点击确定；

ofd.FileName：获取选中文件的完整绝对路径；

通过File.ReadAllText读取文件内容，赋值给窗体标题展示。

四、第二模块：FolderBrowserDialog 文件夹浏览对话框（分段拆解）

1、实例化文件夹对话框

FolderBrowserDialog folderBrowserDialog = new FolderBrowserDialog();

创建文件夹选择弹窗对象，专门用于选择文件夹，无法选中单个文件。

2、Description 提示描述

folderBrowserDialog.Description = "选择一个文件夹";

弹窗顶部自定义提示文字，引导用户操作。

3、RootFolder 设置根目录

folderBrowserDialog.RootFolder = Environment.SpecialFolder.CommonDocuments;

设置对话框的顶级根目录，限制用户只能在该目录下选择文件夹。

常用系统枚举：

Environment.SpecialFolder.Desktop → 桌面

Environment.SpecialFolder.CommonDocuments → 公共文档

4、弹窗并判断选择状态

if (folderBrowserDialog.ShowDialog() == DialogResult.OK)

弹出文件夹选择窗口，判断用户是否点击确定按钮。

5、获取选中文件夹路径

Console.WriteLine(folderBrowserDialog.SelectedPath);
this.Text = folderBrowserDialog.SelectedPath;

SelectedPath属性：专门获取用户选中的文件夹完整绝对路径；

控制台打印路径，同时赋值给窗体标题展示。

五、两种对话框核心区别

1、OpenFileDialog：选择单个文件，可筛选文件格式、读取文件内容；

2、FolderBrowserDialog：选择整个文件夹，只能获取文件夹路径，无法操作单个文件。

六、核心属性总结

OpenFileDialog 常用属性

InitialDirectory：初始打开路径

Title：对话框标题

Filter：文件格式筛选

FileName：获取选中文件完整路径

FolderBrowserDialog 常用属性

Description：弹窗提示文字

RootFolder：设置根目录范围

SelectedPath：获取选中文件夹路径

七、易错点

1、Filter格式必须严格规范，中英文符号不能混用，否则筛选失效；

2、文件夹对话框只能选文件夹，不能读取单个文件内容；

3、必须判断 DialogResult.OK，防止用户点击取消后报错；

4、RootFolder只能设置系统预设目录，不能自定义

对象本地存储（自定义类读写文件）

一、知识点概述

1、默认情况下：对象只能存在内存中，程序关闭、窗口关闭，对象数据直接清空。

2、对象存储核心：将自定义类对象的属性数据，通过文件流写入本地txt文件，实现数据持久化保存。

3、读写流程：

写入：页面数据 → 赋值给对象属性 → FileStream+StreamWriter 逐行写入本地文件

读取：本地文件 → StreamReader逐行读取 → 赋值给新对象属性 → 回显到页面

4、使用using自动释放资源，替代手动Close、Dispose，代码更安全。

二、完整可运行代码

using System;
using System.IO;
using System.Windows.Forms;

namespace _2对象的存储
{
    public partial class Form1 : Form
    {
        public Form1()
        {
            InitializeComponent();
        }

        //【写入按钮：对象数据保存到本地文件】
        private void button1_Click(object sender, EventArgs e)
        {
            //1.实例化人类对象，接收文本框输入的数据
            People p = new People()
            {
                Name = textBox1.Text,
                Age = textBox2.Text,
                Sex = textBox3.Text,
                Phone = textBox4.Text
            };

            //2.创建文件流：创建/覆盖1.txt文件
            FileStream fs = new FileStream(@"1.txt", FileMode.Create);

            //3.创建文本写入流，绑定文件流
            StreamWriter sw = new StreamWriter(fs);

            //4.逐行写入对象的每一个属性
            sw.WriteLine(p.Name);
            sw.WriteLine(p.Age);
            sw.WriteLine(p.Sex);
            sw.WriteLine(p.Phone);

            //5.手动关闭流、释放资源
            sw.Close();
            fs.Close();
            sw.Dispose();
            fs.Dispose();
        }

        //【读取按钮：本地文件数据读取赋值给对象】
        private void button2_Click(object sender, EventArgs e)
        {
            //1.创建空对象，用于接收读取的数据
            People p1 = new People();

            //2.using自动释放文件流资源
            using (FileStream fs = new FileStream(@"1.txt", FileMode.Open))
            {
                //3.创建读取流
                StreamReader sr = new StreamReader(fs);
                //4.逐行读取，赋值给对象属性
                p1.Name = sr.ReadLine();
                p1.Age = sr.ReadLine();
                p1.Sex = sr.ReadLine();
                p1.Phone = sr.ReadLine();
            }

            //5.将对象数据回显到文本框
            textBox1.Text = p1.Name;
        }
    }

    //【自定义人类实体类】
    public class People
    {
        //自动属性：姓名、年龄、性别、电话
        public string Name { get; set; }
        public string Age { get; set; }
        public string Sex { get; set; }
        public string Phone { get; set; }
    }
}

三、代码分段详细拆解

第一段：自定义实体类 People

public class People
{
    public string Name { get; set; }
    public string Age { get; set; }
    public string Sex { get; set; }
    public string Phone { get; set; }
}

作用：封装用户的所有数据信息，统一存储在对象中，方便整体读写操作。

特点：使用自动属性get/set，用于接收、存储数据。

第二段：写入按钮核心逻辑（button1_Click）

1、实例化对象，接收页面数据

People p = new People()
{
    Name = textBox1.Text,
    Age = textBox2.Text,
    Sex = textBox3.Text,
    Phone = textBox4.Text
};

把四个文本框输入的用户数据，全部封装到People对象中。

2、创建文件流 FileStream

FileStream fs = new FileStream(@"1.txt", FileMode.Create);

FileMode.Create：创建文件，文件存在则覆盖原有所有内容，不存在则新建。

3、文本写入流 StreamWriter

StreamWriter sw = new StreamWriter(fs);

专门用于写入文本内容，绑定FileStream文件流。

4、逐行写入对象属性

sw.WriteLine(p.Name);
sw.WriteLine(p.Age);
sw.WriteLine(p.Sex);
sw.WriteLine(p.Phone);

WriteLine：写入数据并自动换行，保证读取时按行对应，数据不乱序。

5、手动关闭与释放资源

sw.Close();
fs.Close();
sw.Dispose();
fs.Dispose();

Close()：关闭流；Dispose()：彻底释放文件资源，防止文件被程序锁定占用。

第三段：读取按钮核心逻辑（button2_Click）

1、创建空对象

People p1 = new People();

定义空对象，用于接收从文件读取出来的数据。

2、using + 文件流打开文件

using (FileStream fs = new FileStream(@"1.txt", FileMode.Open))

FileMode.Open：打开已有文件，文件不存在直接报错。

using作用：代码执行完毕后，自动释放文件流资源，无需手动写Close、Dispose。

3、StreamReader逐行读取赋值

StreamReader sr = new StreamReader(fs);
p1.Name = sr.ReadLine();
p1.Age = sr.ReadLine();
p1.Sex = sr.ReadLine();
p1.Phone = sr.ReadLine();

ReadLine()：按行读取文本，严格对应写入顺序，一一赋值给对象属性。

4、数据回显页面

textBox1.Text = p1.Name;

将读取到的对象数据，重新展示到文本框中，完成数据读取回显。

四、各类文件读写类区别（课堂重点）

1、File.WriteAllText：静态方法，一行代码读写，无需创建流对象；

2、FileStream：文件基础流，负责字节层面读写；

3、StreamWriter / StreamReader：专门读写文本字符串；

4、BufferedStream：缓冲流，提升读写效率；

5、BinaryReader：二进制读写，适合非文本文件。

五、手动释放 vs using释放 区别

1、手动写法：必须写 Close()、Dispose()，少写会导致文件占用、内存泄漏；

2、using写法：执行完大括号代码，自动释放资源，更安全、开发首选。

六、核心原理总结

1、对象不能直接保存到本地，必须拆分为文本/字节数据写入文件；

2、写入顺序和读取顺序必须严格一致，否则数据错乱；

3、FileMode.Create 覆盖写入，FileMode.Open 只读打开；

4、所有流对象使用完毕必须释放资源；

5、实现效果：关闭程序再打开，依然可以读取上次保存的用户数据（数据持久化）。

七、易错点

1、读写顺序不一致，导致属性赋值错乱；

2、写入使用Create覆盖模式，会清空历史数据；

3、忘记关闭释放流资源，文件一直被占用无法修改删除；

4、读取时文件不存在，程序直接报错。