Validating Sharepoint filenames on upload

Some characters are legal for FAT or NTFS files but illegal for files in Sharepoint documentlibraries. Using the regular upload UI for Sharepoint you'll encounter a rather unpleasant validation error when uploading a file with funky characters. Using the object model will give you a good ole' exception.

I've seen a lot of approaches to solving this problem, and implemented a couple myself. Last night I noticed a method on the SPEncode static class that enabled a clean approach to the problem (updated for double punctuation mark problem):

private string CleanForUrlAndFileNameUse(string dirtyFileName)


    char[] dirtyChars = dirtyFileName.ToCharArray();

    foreach (char c in dirtyChars)


        if (!SPEncode.IsLegalCharInUrl(c))


            dirtyFileName = dirtyFileName.Replace(c.ToString(), "");




    // Spaces are not appreciated

    dirtyFileName = dirtyFileName.Replace(" ", "");


    // double punctuation marks causes validation error

    while(dirtyFileName.IndexOf("..") != -1)

        dirtyFileName = dirtyFileName.Replace("..", ".");


    return dirtyFileName; // now clean:-)


Filed under:


# Angus Logan said:

Hey Mads - Nice one!

Wanna wrap it up in a console app which cleans entire directories?

Thursday, November 17, 2005 5:40 AM
# Rabbit66 said:

Where would I add this code? Not a programmer?

Wednesday, October 17, 2007 4:14 PM
# Frank said:

SharePoint vs. File Shares

Of corse file shares!

Tuesday, September 9, 2008 6:08 PM
# devendra said:

Where i have to place this code

Wednesday, January 7, 2009 2:44 AM