C#判断文件名或路径是否包含非法字符

结果与目标

在使用 Windows 操作系统进行开发时，文件和文件夹名称不能包含以下任何字符：\/:*?"<>|。如果允许这些字符进入文件名，不仅会导致文件无法保存，还可能引发系统级异常。

我们的目标是在用户点击“保存”或提交模板名称时，即时验证输入字符串，若发现违规字符则阻止提交并提示用户修改。

准备条件

1. 开发环境：Visual Studio 或兼容 .NET 框架/ .NET Core/.NET 5+ 环境的 IDE。
2. 命名空间：确保代码文件头部已引用 using System.IO; 和 using System.Text;（如需使用 StringBuilder）。
3. 界面控件：假设有一个文本输入框（如 TextBox）用于接收用户输入的文件名或模板名。

第1步：非空判断

目的：在检查内容之前，先确认用户是否有实际输入。虽然这属于基础逻辑，但在处理文件操作时必不可少。

动作：使用 string.IsNullOrWhiteSpace 方法检查字符串是否为 null、空或纯空白。

string strTemplateName = txtTemplateName.Text;
if (string.IsNullOrWhiteSpace(strTemplateName))
{
    // 提示用户输入为空
    Show("请输入模板名称！", "提示", MessageBoxIcon.Information, MessageBoxButtons.OK);
    txtTemplateName.Focus();
    return;
}

第2步：非法字符精准拦截

目的：利用 .NET Framework 内置的标准方法，自动获取当前运行环境下所有不可用的文件名字符集。

入口：用户输入的 strTemplateName 字符串。

重要参数：

• Path.GetInvalidFileNameChars()：返回一个 char 数组，包含 \\, /, :, *, ?, ", <, >, | 等符号。
• IndexOfAny：用于搜索字符数组在字符串中首次出现的位置。

动作与实现：

// 获取系统的非法字符列表
char[] invalidChars = Path.GetInvalidFileNameChars();

// 检查字符串中是否包含这些字符
if (strTemplateName.IndexOfAny(invalidChars) >= 0)
{
    // 含有非法字符的处理逻辑
    Show("模板名称含有非法字符（如 \\ / : * ? " < > |），请重新输入", "错误", MessageBoxIcon.Error, MessageBoxButtons.OK);
    txtTemplateName.Focus();
    txtTemplateName.Select();
    return;
}

原理解析：IndexOfAny 一旦在字符串中找到匹配数组中的任意一个字符，就会返回该字符的索引位置（从 0 开始）。如果返回 -1，说明未找到任何非法字符；如果返回值 >= 0，则说明存在非法字符。

完成判断与注意事项

当上述代码执行后，如果输入合法，程序将继续后续的文件写入或数据库保存流程。如果出现报错窗口且光标聚焦回输入框，即判定为拦截成功。

排错与建议：

• 性能优化：Path.GetInvalidFileNameChars() 在 .NET 中通常会缓存结果，因此直接调用是高效的。若在某些极端高性能场景下频繁调用，可考虑将其赋值给静态只读变量以提升微秒级的响应速度，但对于一般的 UI 交互来说，直接使用即可。
• 跨平台差异：此方法主要针对 Windows NTFS/FAT 文件系统设计。如果在 Linux/macOS 上运行，Path.GetInvalidFileNameChars() 依然能工作，但具体的非法字符可能有所不同（例如 / 在所有类 Unix 系统都是分隔符，而 : 在某些系统中仅保留作为卷标分隔）。通常建议使用此方法来保证兼容性。
• 替代方案：对于简单的字符排除，有时也会使用正则表达式，但正则表达式的编写容易出错且维护成本高。相比之下，Path.GetInvalidFileNameChars 是最标准且不易出错的官方推荐做法。

以上就是 C# 中判断文件名或文件路径非法字符的详细内容，更多关于 C# 文件操作规范及路径处理的资料请关注本站其它相关文章！