Question

I have a feeling this could be a basic question!

I have a complex object ie a document object which contains properties that are lists of other objects. It has been created by deserializing some XML.

I would like to pass the entire Model to the View

Return ViewResult(MyDoc)

In the View some properties are edited. Control is then returned back to the Post Controller:

        [AcceptVerbs(HttpVerbs.Post)]
    public ActionResult Index(Document myDoc)

“myDoc” now just represents my Form’s fields. I suspect this is ModelBinding at work. So I guess I need to persist my complex object in a hidden field(example would be great) or as a session object. However I am a bit confused how my updated field gets merged back into the persisted object(hidden or session).

Answer 1

You are right, this is model binding at work.

The binding occurs almost automatically when you use HtmlHelpers such as :

@Html.TextboxFor(model => model.PropertyName)

This line actually creates something a little bit like this :

<input type="textbox" id="Modelobject_PropertyName" name="ModelObject.PropertyName" />

Then when you submit your form, the DefaultModelBinder is able to deserialize the POST value and create and object of the given type (at least it will try), if it can’t find a corresponding entry, the property will be null and if an entry have no corresponding property, it will be ignored (unless you have other parameters).

You can read this article it’s a little bit old, but it’s still pretty accurate.

As an exemple:

Let’s say you have a simple object :

public class IndexModel
{
    public string MyProperty { get; set; }
    public bool MyCheckbox { get; set; }
}

A simple controler :

public class TestingController : Controller
{
    [OutputCache(Duration=0, NoStore = true)]
    public ActionResult Index()
    {
        return View(new IndexModel { MyProperty = "hi" });
    }

    [HttpPost]
    [OutputCache(Duration=0, NoStore = true)]
    public ActionResult Index(IndexModel model)
    {
        model.MyProperty += "!";
        ModelState.Clear();
        return View(model);
    }
}

And a simple view :

@model MvcApp.Models.IndexModel

@using (Html.BeginForm())
{
    <div>
        @Html.LabelFor(model => model.MyProperty)<p />
        @Html.TextBoxFor(model => model.MyProperty) 
    </div>
    <div>
        @Html.LabelFor(model => model.MyCheckbox)<p />
        @Html.CheckBoxFor(model => model.MyCheckbox)
    </div> 

    <input type="submit" />
}

You will see, when you submit the form, that the model is recreated completely.

If you don’t want to display the actual value of a property, but still need it persisted:

@Html.HiddenFor(model => model.MyProperty)

This will generate a hidden field that will be posted back and, therefor, persisted.

Happy coding !