Controllers model binding

Controllers model binding

View model can be serialized from a HTTP GET request query string or a POST data and then used in the controller. To do this, you should use Controller<T> or AsyncController<T> base classes for your controller, and then specify a model type in type parameter T.

Example

View model class

public class LoginViewModel
{
    [Required]
    public string UserName { get; set; }

    [Required]
    public string Password { get; set; }

    public bool RememberMe { get; set; }
}

Controller

public class LoginController : Controller<LoginViewModel>
{
    public override ControllerResponse Invoke()
    {
        // Accessing serialized model
        if (Model.Password == ... && Model.UserName == ...)
        {
            ...
        }

        ...
    }
}

Form

<form method="post">
    <input type="text" name="UserName" />
    <input type="Password" name="Password" />
    <input type="checkbox" name="RememberMe"/> Remember me
    <button type="submit">Login</button>
</form>

Note, what model serialization and validation will be executed only on the Model property first access.

By default view model will be serialized from the HTTP GET query string or the HTTP POST form data (depending on current request method). For a JSON type of data you can use JSON serializer.

Properties types

Supported view model properties types by default: string, bool, bool?, int, int?, decimal, decimal?, DateTime, DateTime?, long, long?.

For DateTime serialization you can use DateTimeFormat attribute. By this attribute you can specify the DateTime source data format, for example: [DateTimeFormat("dd.MM.yyyy Hh:mm")]

Properties validation

All validation attributes can be found in Simplify.Web.ModelBinding.Attributes namespace;

Available properties validation attributes by default:

• [Required] - indicates what field is a required field (can be set for any supported field types);
• [MaxLength(5)] - specifies string property maximum length;
• [MinLength(2)] - specifies string property minimum length;
• [EMailAttribute(2)] - string property should be a valid e-mail address;
• [Regex(^[a-zA-Z]+$)] - string property should match specified regular expression;

Custom validation attributes error message

All validation attributes specified above support custom error message, both directly from string table or just by specifying some string.

When specifying custom error message, by default it will try to load string from StringTable, by it is label ID, for example:

The model

public class LoginViewModel
{
    [Required("NotifyUserNameIsRequired")]
    public string UserName { get; set; }
}

The default StringTable.en.xml from App_Data

<?xml version="1.0" encoding="utf-8" ?>

<items>
    <item name="NotifyUserNameIsRequired" value="User name is required" />
</items>

If you want to specify error message without StringTable you should set second attribute parameter isMessageFromStringTable to false, for example:

public class LoginViewModel
{
    [Required("User name is required", false)]
    public string UserName { get; set; }
}

Full example

<< Previous page Next page >>