> For the complete documentation index, see [llms.txt](https://dailyjournal.gitbook.io/notes/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dailyjournal.gitbook.io/notes/web-frameworks/asp.net-core/web-apps/mvc/models/model-binding.md).

# Model Binding

Controllers and Razor pages work with data that comes from HTTP requests. 

For example, route data may provide a record key, and posted form fields may provide values for the properties of the model. Model binding automates the process retrieve each of these values and convert them from strings to .NET types. 

The model binding system:

* Retrieves data from various sources such as route data, form fields, and query strings.
* Provides the data to controllers and Razor pages in method parameters and public properties.
* Converts string data to .NET types and updates properties of complex types.

### Attribute Binding

* `[BindProperty]` attribute

this attribute can be applied to a public property of a `ControllerBase` or `PageModel` class to cause model binding to target that property.

```csharp
public class UserController : ControllerBase {
    [BindProperty]
    public User? User { get; set; }
}
```

* `[BindProperties]` attribute

this attribute can be applied to a `ControllerBase` or `PageModel` class to cause model binding to target all the public properties of the class.

```csharp
[BindProperties]
public class UserModel : PageModel {
    public User? User { get; set; }
}
```

{% hint style="info" %}
By default, properties are not bound to data for HTTP GET requests. To do so, we just need to set the `SupportsGet` property to `true`. For Example:

* `[BindProperty(SupportsGet = true)]` for method
* `[BindProperties(SupportsGet = true)]` for class
  {% endhint %}

### Binding Sources

By default, model binding gets data in the form of key-value pairs from the following order of sources in an HTTP request:

1. Form fields
2. The request body
3. Route data
4. Query string parameters
5. Uploaded files (bound only to target types that implement `IFormFile` or `IEnumerable<IFormFile>`)

If we do not want to use the default source of model binding, we can use the following attributes to specify the source:

<table data-header-hidden><thead><tr><th width="175"></th><th></th></tr></thead><tbody><tr><td><code>[FromRoute]</code></td><td>Gets values from route data.</td></tr><tr><td><code>[FromQuery]</code></td><td>Gets values from the query string (?).</td></tr><tr><td><code>[FromHeader]</code></td><td>Gets values from HTTP headers.</td></tr><tr><td><code>[FromBody]</code></td><td>Gets values from the request body.</td></tr><tr><td><code>[FromForm]</code></td><td>Gets values from posted form fields.</td></tr></tbody></table>

### Custom Model Binding Sources

Source data is provided to the model binding system by *value providers*. You can write and register custom value providers that get data for model binding from other sources. \
For example, you might want data from cookies or session state.&#x20;

To get data from a new source:

* Create a class that implements `IValueProvider`.
* Create a class that implements `IValueProviderFactory`.
* Register the custom value provider factory classes in `Program.cs`.

```csharp
builder.Services.AddControllers(options =>
{
    // puts the custom value provider after all built-in value providers
    options.ValueProviderFactories.Add(new CookieValueProviderFactory());
    // to make it the first in the list, call Insert() instead of Add()
    options.ValueProviderFactories.Insert(0, new CookieValueProviderFactory());
});
```

The record of what data is bound to the model, and any binding or validation errors, is stored in `ControllerBase.ModelState` or `PageModel.ModelState`.&#x20;


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://dailyjournal.gitbook.io/notes/web-frameworks/asp.net-core/web-apps/mvc/models/model-binding.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.