Search code examples
c#formsvalidationasp.net-mvc-4

How Can I Use Data Annotations Attribute Classes to Fail Empty Strings in Forms?


I was trying to require a text input field in a form, which implies that there needs to be something in the form. However, adding a [Required] tag to my model wasn't working. Specifically, look at the User Name property:

public class ColumnWidthMetaData {
    [DisplayName("Column Name")]
    [Required]
    public string ColName { get; set; }

    [DisplayName("Primary Key")]
    public int pKey { get; set; }

    [DisplayName("User Name")]
    [Required]
    public string UserName { get; set; }

    [DisplayName("Column Width")]
    [Required]
    public int Width { get; set; }
}

This allows empty strings to get past model validation and eventually a database error is thrown when it attempts to insert a NULL value for User Name.

How can I change these attributes so they do what they seem like they should do?


Solution

  • After a lot of Googling and looking on Stackoverflow, I had nothing.

    I went to MSDN and looked at the System.ComponentModel.DataAnnotations Namespace.

    There I looked more closely at the Required attribute, and noticed the AllowEmptyStrings property. Setting this to false tells the attribute not to allow any empty strings. In at least some versions this is the default behavior, which makes sense seeing as how the point of Required is to require that something be entered, and an empty string indicates that nothing was entered. You may not need to add this, if it's the default, but it doesn't hurt to be explicit.

    This doesn't solve the problem though, as by default empty strings are coerced to null, which is not an empty string, and is therefore allowed. This seems absurd, as Required is supposed to test if something was entered, and null indicates nothing was entered. However, the AllowEmptyStrings page has a link to DisplayFormAttribute's Property ConvertEmptyStringsToNull. If you set this to false, then empty strings will remain empty strings, and then the required tag will not allow them.

    So, here's the fix:

    public class ColumnWidthMetaData {
        [DisplayName("Column Name")]
        [Required(AllowEmptyStrings=false)]
        [DisplayFormat(ConvertEmptyStringToNull=false)]
        public string ColName { get; set; }
    
        [DisplayName("Primary Key")]
        public int pKey { get; set; }
    
        [DisplayName("User Name")]
        [Required(AllowEmptyStrings=false)]
        [DisplayFormat(ConvertEmptyStringToNull=false)]
        public string UserName { get; set; }
    
        [DisplayName("Column Width")]
        [Required]
        public int Width { get; set; }
    }