如何在Windows下检查给定字符串是否是合法/有效的文件名?

时间:2008-09-15 13:17:30

标签: c# windows file filesystems

我想在我的应用程序中包含批处理文件重命名功能。用户可以键入目标文件名模式和(在替换模式中的一些通配符之后)我需要检查它是否是Windows下的合法文件名。我试图使用像[a-zA-Z0-9_]+这样的正则表达式,但它不包含来自各种语言的许多国家特定字符(例如变音符号等)。做这种检查的最佳方法是什么?

27 个答案:

答案 0 :(得分:119)

MSDN's "Naming a File or Directory,"开始,以下是Windows下合法文件名的一般约定:

您可以使用当前代码页中的任何字符(Unicode / ANSI高于127),但不包括:

  • < > : " / \ | ? *
  • 整数表示为0-31(小于ASCII空格)
  • 的字符
  • 目标文件系统不允许的任何其他字符(例如,尾随句点或空格)
  • 任何DOS名称:CON,PRN,AUX,NUL,COM0,COM1,COM2,COM3,COM4,COM5,COM6,COM7,COM8,COM9,LPT0,LPT1,LPT2,LPT3,LPT4,LPT5,LPT6 ,LPT7,LPT8,LPT9(并避免AUX.txt等)
  • 文件名是所有期间

要检查的一些可选项:

  • 文件路径(包括文件名)不得超过260个字符(不使用\?\前缀)
  • 使用\?\时超过32,000个字符的Unicode文件路径(包括文件名)(请注意,前缀可能会扩展目录组件并导致其溢出32,000个限制)

答案 1 :(得分:97)

您可以从Path.GetInvalidPathCharsGetInvalidFileNameChars获取无效字符列表。

UPD:有关如何在正则表达式中使用这些内容,请参阅Steve Cooper's suggestion

UPD2:请注意,根据MSDN中的“备注”部分,“不保证从此方法返回的数组包含文件和目录名称中无效的完整字符集”。 The answer provided by sixlettervaliables详细介绍。

答案 2 :(得分:63)

对于3.5之前的 .Net框架,这应该可行:

正则表达式匹配应该可以帮到你。这是使用System.IO.Path.InvalidPathChars常量的片段

bool IsValidFilename(string testName)
{
    Regex containsABadCharacter = new Regex("[" 
          + Regex.Escape(System.IO.Path.InvalidPathChars) + "]");
    if (containsABadCharacter.IsMatch(testName)) { return false; };

    // other checks for UNC, drive-path format, etc

    return true;
}

对于 .Net Frameworks 3.0之后,这应该可行:

http://msdn.microsoft.com/en-us/library/system.io.path.getinvalidpathchars(v=vs.90).aspx

正则表达式匹配应该可以帮到你。这是使用System.IO.Path.GetInvalidPathChars()常量的片段

bool IsValidFilename(string testName)
{
    Regex containsABadCharacter = new Regex("["
          + Regex.Escape(new string(System.IO.Path.GetInvalidPathChars())) + "]");
    if (containsABadCharacter.IsMatch(testName)) { return false; };

    // other checks for UNC, drive-path format, etc

    return true;
}

一旦你知道,你还应该检查不同的格式,例如c:\my\drive\\server\share\dir\file.ext

答案 3 :(得分:25)

尝试使用它,并捕获错误。允许的集可能会跨文件系统或跨不同版本的Windows进行更改。换句话说,如果您想知道Windows是否喜欢该名称,请将其命名并让它告诉您。

答案 4 :(得分:23)

此类清除文件名和路径;像

一样使用它
var myCleanPath = PathSanitizer.SanitizeFilename(myBadPath, ' ');

这是代码;

/// <summary>
/// Cleans paths of invalid characters.
/// </summary>
public static class PathSanitizer
{
    /// <summary>
    /// The set of invalid filename characters, kept sorted for fast binary search
    /// </summary>
    private readonly static char[] invalidFilenameChars;
    /// <summary>
    /// The set of invalid path characters, kept sorted for fast binary search
    /// </summary>
    private readonly static char[] invalidPathChars;

    static PathSanitizer()
    {
        // set up the two arrays -- sorted once for speed.
        invalidFilenameChars = System.IO.Path.GetInvalidFileNameChars();
        invalidPathChars = System.IO.Path.GetInvalidPathChars();
        Array.Sort(invalidFilenameChars);
        Array.Sort(invalidPathChars);

    }

    /// <summary>
    /// Cleans a filename of invalid characters
    /// </summary>
    /// <param name="input">the string to clean</param>
    /// <param name="errorChar">the character which replaces bad characters</param>
    /// <returns></returns>
    public static string SanitizeFilename(string input, char errorChar)
    {
        return Sanitize(input, invalidFilenameChars, errorChar);
    }

    /// <summary>
    /// Cleans a path of invalid characters
    /// </summary>
    /// <param name="input">the string to clean</param>
    /// <param name="errorChar">the character which replaces bad characters</param>
    /// <returns></returns>
    public static string SanitizePath(string input, char errorChar)
    {
        return Sanitize(input, invalidPathChars, errorChar);
    }

    /// <summary>
    /// Cleans a string of invalid characters.
    /// </summary>
    /// <param name="input"></param>
    /// <param name="invalidChars"></param>
    /// <param name="errorChar"></param>
    /// <returns></returns>
    private static string Sanitize(string input, char[] invalidChars, char errorChar)
    {
        // null always sanitizes to null
        if (input == null) { return null; }
        StringBuilder result = new StringBuilder();
        foreach (var characterToTest in input)
        {
            // we binary search for the character in the invalid set. This should be lightning fast.
            if (Array.BinarySearch(invalidChars, characterToTest) >= 0)
            {
                // we found the character in the array of 
                result.Append(errorChar);
            }
            else
            {
                // the character was not found in invalid, so it is valid.
                result.Append(characterToTest);
            }
        }

        // we're done.
        return result.ToString();
    }

}

答案 5 :(得分:22)

这就是我使用的:

    public static bool IsValidFileName(this string expression, bool platformIndependent)
    {
        string sPattern = @"^(?!^(PRN|AUX|CLOCK\$|NUL|CON|COM\d|LPT\d|\..*)(\..+)?$)[^\x00-\x1f\\?*:\"";|/]+$";
        if (platformIndependent)
        {
           sPattern = @"^(([a-zA-Z]:|\\)\\)?(((\.)|(\.\.)|([^\\/:\*\?""\|<>\. ](([^\\/:\*\?""\|<>\. ])|([^\\/:\*\?""\|<>]*[^\\/:\*\?""\|<>\. ]))?))\\)*[^\\/:\*\?""\|<>\. ](([^\\/:\*\?""\|<>\. ])|([^\\/:\*\?""\|<>]*[^\\/:\*\?""\|<>\. ]))?$";
        }
        return (Regex.IsMatch(expression, sPattern, RegexOptions.CultureInvariant));
    }

第一个模式创建一个正则表达式,其中仅包含Windows平台的无效/非法文件名和字符。第二个是相同的,但确保该名称对任何平台都是合法的。

答案 6 :(得分:18)

要记住一个角落的情况,当我第一次发现它时让我感到惊讶:Windows允许文件名中的前导空格字符!例如,以下是Windows上的所有合法且不同的文件名(减去引号):

"file.txt"
" file.txt"
"  file.txt"

一个要点:在编写修剪文件名字符串中前导/尾随空格的代码时要小心。

答案 7 :(得分:9)

简化Eugene Katz的回答:

bool IsFileNameCorrect(string fileName){
    return !fileName.Any(f=>Path.GetInvalidFileNameChars().Contains(f))
}

或者

bool IsFileNameCorrect(string fileName){
    return fileName.All(f=>!Path.GetInvalidFileNameChars().Contains(f))
}

答案 8 :(得分:8)

Microsoft Windows:Windows内核禁止使用范围1-31(即0x01-0x1F)和字符“*:&lt;&gt;?\ |中的字符。虽然NTFS允许每个路径组件(目录或文件名) Windows内核长度为255个字符,长度约为32767个字符,Windows内核仅支持最长259个字符的路径。此外,Windows禁止使用MS-DOS设备名称AUX,CLOCK $,COM1,COM2,COM3,COM4 ,COM5,COM6,COM7,COM8,COM9,CON,LPT1,LPT2,LPT3,LPT4,LPT5,LPT6,LPT7,LPT8,LPT9,NUL和PRN,以及具有任何扩展名的这些名称(例如,AUX.txt) ),除了使用长UNC路径(例如\。\ C:\ nul.txt或\?\ D:\ aux \ con)时。(实际上,如果提供了扩展,可以使用CLOCK $。)这些限制仅适用于Windows - 例如,Linux允许使用“*:&lt; &GT; ? \ |甚至在NTFS。

来源:http://en.wikipedia.org/wiki/Filename

答案 9 :(得分:7)

您可以使用正则表达式检查是否存在非法字符,然后报告错误,而不是明确包含所有可能的字符。理想情况下,您的应用程序应该完全按照用户的意愿命名文件,并且只有在遇到错误时才会犯规。

答案 10 :(得分:6)

我用它来摆脱文件名中的无效字符而不抛出异常:

private static readonly Regex InvalidFileRegex = new Regex(
    string.Format("[{0}]", Regex.Escape(@"<>:""/\|?*")));

public static string SanitizeFileName(string fileName)
{
    return InvalidFileRegex.Replace(fileName, string.Empty);
}

答案 11 :(得分:5)

CON,PRN,AUX,NUL,COM#和其他一些内容在任何扩展名的任何目录中都不是合法的文件名。

答案 12 :(得分:5)

问题是您是在尝试确定路径名是合法的Windows路径,还是在运行代码的系统上是否合法?我认为后者更重要,所以个人而言,我可能会分解完整路径并尝试使用_mkdir创建文件所属的目录,然后尝试创建该文件。

这样,您不仅知道路径是否仅包含有效的Windows字符,还知道它实际上是否代表了此进程可以写入的路径。

答案 13 :(得分:4)

为了补充其他答案,您可能需要考虑以下几个其他边缘情况。

答案 14 :(得分:3)

MSDN开始,这是一个不允许的字符列表:

  
    
      
        

使用当前代码页中的几乎任何字符作为名称,包括扩展字符集(128-255)中的Unicode字符和字符,但以下情况除外:

                 
            
  • 不允许使用以下保留字符:          &LT; &GT; :“/ \ |?*
  •         
  • 不允许整数表示形式在0到31范围内的字符。
  •         
  • 目标文件系统不允许的任何其他字符。
  •         
      
    
  

答案 15 :(得分:2)

目标文件系统也很重要。

在NTFS下,无法在特定目录中创建某些文件。 例如。 $ boot in root

答案 16 :(得分:2)

这是一个已经回答的问题,但仅仅是为了&#34;其他选项&#34;,这里是一个非理想的问题:

(非理想,因为使用Exceptions作为流量控制是&#34; Bad Thing&#34;,通常)

public static bool IsLegalFilename(string name)
{
    try 
    {
        var fileInfo = new FileInfo(name);
        return true;
    }
    catch
    {
        return false;
    }
}

答案 17 :(得分:2)

正则表达式对于这种情况来说是过度的。您可以将String.IndexOfAny()方法与Path.GetInvalidPathChars()Path.GetInvalidFileNameChars()结合使用。

另请注意,两个Path.GetInvalidXXX()方法都克隆内部数组并返回克隆。因此,如果您要执行此操作(成千上万次),则可以缓存无效字符数组的副本以供重用。

答案 18 :(得分:1)

如果文件名太长而且许多这些答案都不起作用。在Windows 10之前的环境中运行。同样,考虑一下你想用句点做什么 - 允许前导或尾随在技术上是有效的,但如果你不希望文件分别难以看到或删除,可能会产生问题。

这是我为检查有效文件名而创建的验证属性。

public class ValidFileNameAttribute : ValidationAttribute
{
    public ValidFileNameAttribute()
    {
        RequireExtension = true;
        ErrorMessage = "{0} is an Invalid Filename";
        MaxLength = 255; //superseeded in modern windows environments
    }
    public override bool IsValid(object value)
    {
        //http://stackoverflow.com/questions/422090/in-c-sharp-check-that-filename-is-possibly-valid-not-that-it-exists
        var fileName = (string)value;
        if (string.IsNullOrEmpty(fileName)) { return true;  }
        if (fileName.IndexOfAny(Path.GetInvalidFileNameChars()) > -1 ||
            (!AllowHidden && fileName[0] == '.') ||
            fileName[fileName.Length - 1]== '.' ||
            fileName.Length > MaxLength)
        {
            return false;
        }
        string extension = Path.GetExtension(fileName);
        return (!RequireExtension || extension != string.Empty)
            && (ExtensionList==null || ExtensionList.Contains(extension));
    }
    private const string _sepChar = ",";
    private IEnumerable<string> ExtensionList { get; set; }
    public bool AllowHidden { get; set; }
    public bool RequireExtension { get; set; }
    public int MaxLength { get; set; }
    public string AllowedExtensions {
        get { return string.Join(_sepChar, ExtensionList); } 
        set {
            if (string.IsNullOrEmpty(value))
            { ExtensionList = null; }
            else {
                ExtensionList = value.Split(new char[] { _sepChar[0] })
                    .Select(s => s[0] == '.' ? s : ('.' + s))
                    .ToList();
            }
    } }

    public override bool RequiresValidationContext => false;
}

和测试

[TestMethod]
public void TestFilenameAttribute()
{
    var rxa = new ValidFileNameAttribute();
    Assert.IsFalse(rxa.IsValid("pptx."));
    Assert.IsFalse(rxa.IsValid("pp.tx."));
    Assert.IsFalse(rxa.IsValid("."));
    Assert.IsFalse(rxa.IsValid(".pp.tx"));
    Assert.IsFalse(rxa.IsValid(".pptx"));
    Assert.IsFalse(rxa.IsValid("pptx"));
    Assert.IsFalse(rxa.IsValid("a/abc.pptx"));
    Assert.IsFalse(rxa.IsValid("a\\abc.pptx"));
    Assert.IsFalse(rxa.IsValid("c:abc.pptx"));
    Assert.IsFalse(rxa.IsValid("c<abc.pptx"));
    Assert.IsTrue(rxa.IsValid("abc.pptx"));
    rxa = new ValidFileNameAttribute { AllowedExtensions = ".pptx" };
    Assert.IsFalse(rxa.IsValid("abc.docx"));
    Assert.IsTrue(rxa.IsValid("abc.pptx"));
}

答案 19 :(得分:1)

如果您只是想检查包含文件名/路径的字符串是否包含任何无效字符,我发现的最快方法是使用Split()将文件名拆分为数组零件无效的地方。如果结果只是1的数组,则没有无效字符。 : - )

var nameToTest = "Best file name \"ever\".txt";
bool isInvalidName = nameToTest.Split(System.IO.Path.GetInvalidFileNameChars()).Length > 1;

var pathToTest = "C:\\My Folder <secrets>\\";
bool isInvalidPath = pathToTest.Split(System.IO.Path.GetInvalidPathChars()).Length > 1;

我尝试在LinqPad中将文件/路径名上面提到的这个和其他方法运行1,000,000次。

使用Split()只需约850毫秒。

使用Regex("[" + Regex.Escape(new string(System.IO.Path.GetInvalidPathChars())) + "]")约为6秒。

更复杂的正则表达式更糟糕,其他一些选项也是如此,例如使用Path类上的各种方法获取文件名并让其内部验证完成工作(很可能是由于异常处理的开销。)

当然,您不需要经常验证100万个文件名,因此无论如何,对于大多数这些方法来说,单次迭代就可以了。但如果你只是在寻找无效的字符,它仍然非常高效和有效。

答案 20 :(得分:1)

我的尝试:

using System.IO;

static class PathUtils
{
  public static string IsValidFullPath([NotNull] string fullPath)
  {
    if (string.IsNullOrWhiteSpace(fullPath))
      return "Path is null, empty or white space.";

    bool pathContainsInvalidChars = fullPath.IndexOfAny(Path.GetInvalidPathChars()) != -1;
    if (pathContainsInvalidChars)
      return "Path contains invalid characters.";

    string fileName = Path.GetFileName(fullPath);
    if (fileName == "")
      return "Path must contain a file name.";

    bool fileNameContainsInvalidChars = fileName.IndexOfAny(Path.GetInvalidFileNameChars()) != -1;
    if (fileNameContainsInvalidChars)
      return "File name contains invalid characters.";

    if (!Path.IsPathRooted(fullPath))
      return "The path must be absolute.";

    return "";
  }
}

这并不完美,因为Path.GetInvalidPathChars不会返回文件和目录名称无效的完整字符集,当然还有更多细微之处。

所以我使用这种方法作为补充:

public static bool TestIfFileCanBeCreated([NotNull] string fullPath)
{
  if (string.IsNullOrWhiteSpace(fullPath))
    throw new ArgumentException("Value cannot be null or whitespace.", "fullPath");

  string directoryName = Path.GetDirectoryName(fullPath);
  if (directoryName != null) Directory.CreateDirectory(directoryName);
  try
  {
    using (new FileStream(fullPath, FileMode.CreateNew)) { }
    File.Delete(fullPath);
    return true;
  }
  catch (IOException)
  {
    return false;
  }
}

尝试创建文件,如果有异常则返回false。当然,我需要创建文件,但我认为这是最安全的方法。另请注意,我没有删除已创建的目录。

您也可以使用第一种方法进行基本验证,然后在使用路径时仔细处理异常。

答案 21 :(得分:0)

我建议只使用Path.GetFullPath()

string tagetFileFullNameToBeChecked;
try
{
  Path.GetFullPath(tagetFileFullNameToBeChecked)
}
catch(AugumentException ex)
{
  // invalid chars found
}

答案 22 :(得分:0)

我从某人那里得到了这个想法。 - 不知道是谁。让操作系统完成繁重工作。

public bool IsPathFileNameGood(string fname)
{
    bool rc = Constants.Fail;
    try
    {
        this._stream = new StreamWriter(fname, true);
        rc = Constants.Pass;
    }
    catch (Exception ex)
    {
        MessageBox.Show(ex.Message, "Problem opening file");
        rc = Constants.Fail;
    }
    return rc;
}

答案 23 :(得分:0)

此检查

static bool IsValidFileName(string name)
{
    return
        !string.IsNullOrWhiteSpace(name) &&
        name.IndexOfAny(Path.GetInvalidFileNameChars()) < 0 &&
        !Path.GetFullPath(name).StartsWith(@"\\.\");
}

过滤掉带有无效字符(<>:"/\|?*和ASCII 0-31)的名称,以及保留的DOS设备(CONNULCOMx)。它允许前导空格和全点名称,与Path.GetFullPath一致。 (在我的系统上创建带有前导空格的文件成功)。

在Windows 7上测试过的.NET Framework 4.7.1。

答案 24 :(得分:0)

一个用于验证字符串中非法字符的衬里:

public static bool IsValidFilename(string testName) => !Regex.IsMatch(testName, "[" + Regex.Escape(new string(System.IO.Path.InvalidPathChars)) + "]");

答案 25 :(得分:0)

我认为,对此问题的唯一正确答案是尝试使用路径,并让OS和文件系统对其进行验证。否则,您只是在重新实现(并且可能效果很差)操作系统和文件系统已经使用的所有验证规则,并且如果将来更改了这些规则,则必须更改代码以匹配它们。

答案 26 :(得分:-1)

Windows文件名非常不受限制,所以实际上它甚至可能 很多问题。 Windows不允许的字符是:

\ / : * ? " < > |

您可以轻松编写表达式来检查这些字符是否存在。一个更好的解决方案是尝试按用户需要命名文件,并在文件名不粘时提醒他们。