Controller.TryUpdateModel<TModel> Method (TModel, String, String[], String[])
Updates the specified model instance using values from the controller's current value provider, a prefix, a list of properties to exclude, and a list of properties to include.
Namespace: System.Web.Mvc
Assembly: System.Web.Mvc (in System.Web.Mvc.dll)
Syntax
'Declaration
Protected Friend Function TryUpdateModel(Of TModel As Class) ( _
model As TModel, _
prefix As String, _
includeProperties As String(), _
excludeProperties As String() _
) As Boolean
protected internal bool TryUpdateModel<TModel>(
TModel model,
string prefix,
string[] includeProperties,
string[] excludeProperties
)
where TModel : class
protected public:
generic<typename TModel>
where TModel : ref class
bool TryUpdateModel(
TModel model,
String^ prefix,
array<String^>^ includeProperties,
array<String^>^ excludeProperties
)
Type Parameters
- TModel
The type of the model object.
Parameters
- model
Type: TModel
The model instance to update.
- prefix
Type: System.String
The prefix to use when looking up values in the value provider
- includeProperties
Type: System.String[]
A list of properties of the model to update.
- excludeProperties
Type: System.String[]
A list of properties to explicitly exclude from the update. These are excluded even if they are listed in the includeProperties parameter list.
Return Value
Type: System.Boolean
true if the update is successful; otherwise, false.
Exceptions
| Exception | Condition |
|---|---|
| ArgumentNullException | The model parameter or the ValueProvider property is null reference (Nothing in Visual Basic). |
Remarks
You do not have to explicitly specify the generic parameter TModel. Instead, you can let the C# or Visual Basic type inference engine determine the generic parameter TModel by omitting it.
The TryUpdateModel method is like the UpdateModel method except that the TryUpdateModel method does not throw an InvalidOperationException exception if the updated model state is not valid.