# FolderCreationApp

**Repository Path**: timep/folder-creation-app

## Basic Information

- **Project Name**: FolderCreationApp
- **Description**: 快速批量建立文件夹
- **Primary Language**: C#
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-03-05
- **Last Updated**: 2025-03-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# FolderCreationApp

#### 介绍
快速批量建立文件夹

#### 软件架构
软件架构说明

    整体架构
    该软件采用 Windows Forms 架构，基于 .NET 框架开发，是典型的桌面应用程序架构。主要由以下几个部分组成：
    用户界面（UI）：使用 Windows Forms 控件构建，包括文本框、按钮、列表框、进度条等，用于与用户进行交互，接收用户输入并显示操作结果。
    业务逻辑层：负责处理文件夹创建、INI 文件读写、输入验证等核心业务逻辑。
    数据存储层：使用 INI 文件存储子文件夹名称列表，实现数据的持久化。
    模块详细说明
    主窗体类（MainForm）
    继承自 Form 类，是整个应用程序的入口和核心界面。
    负责初始化界面控件、处理各种事件（如按钮点击、文本框输入、拖放操作等），并调用相应的业务逻辑方法。
    文件夹创建逻辑
    createBtn_Click 方法：处理 “创建” 按钮的点击事件，负责检查用户输入的目标目录和主文件夹名称的有效性，测试目标目录的写入权限，创建主文件夹和子文件夹，并显示创建结果。
    INI 文件读写逻辑
    ReadIniFile 方法：在程序启动时读取 INI 文件中的子文件夹名称列表，并添加到 ListBox 中。
    SaveToIniFile 方法：在程序关闭时将 ListBox 中的子文件夹名称列表保存到 INI 文件中。
    输入验证逻辑
    IsValidFolderName 方法：检查文件夹名称是否包含无效字符，确保输入的名称符合操作系统的命名规则。
    在各个文本框的 TextChanged 事件处理方法中，对用户输入进行实时验证，并在输入无效时给出提示。
    自定义输入对话框（Prompt 类）
    提供一个简单的自定义输入对话框，用于让用户输入新的子文件夹名称。

#### 安装教程

    安装与启动
    该软件为独立的可执行文件（.exe），无需安装，直接双击运行即可。
    
#### 使用说明

    操作步骤
    选择目标目录
    点击 “浏览” 按钮，在弹出的文件夹选择对话框中选择要创建文件夹的目标目录，选择后目标目录路径会显示在文本框中。
    也可以直接将文件夹拖放到目标路径文本框中。
    输入主文件夹名称
    在 “主文件夹名称” 文本框中输入要创建的主文件夹的名称。
    输入的名称不能包含操作系统禁止的字符，否则会弹出提示框要求重新输入。
    管理子文件夹名称列表
    软件启动时会自动加载上次保存的子文件夹名称列表，若首次使用或 INI 文件不存在，则显示默认的子文件夹名称列表（“合同”、“分析文件”、“接收文件”、“照片”、“图片”）。
    点击 “添加” 按钮，在弹出的输入框中输入新的子文件夹名称，点击 “确定” 后，若名称有效且不重复，则会添加到列表中。
    选中列表中的某个子文件夹名称，点击 “删除” 按钮可将其从列表中移除。
    创建文件夹
    确认目标目录、主文件夹名称和子文件夹名称列表无误后，点击 “创建” 按钮。
    软件会先检查目标目录是否存在以及是否有写入权限，若检查通过，则开始创建主文件夹和子文件夹。
    创建过程中，进度条会显示创建进度，状态标签会显示当前正在处理的文件夹名称。
    创建完成后，会弹出消息框显示创建结果，包括成功创建的文件夹数量和已存在而跳过创建的文件夹名称。
    查看关于信息
    点击 “关于” 按钮，会弹出消息框显示软件的相关信息，如版本号、作者、发布时间等。
    关闭程序
    点击 “取消” 按钮或关闭窗体，程序会自动将当前的子文件夹名称列表保存到 INI 文件中，下次启动时会加载这些名称。