Controller.TryUpdateModel<TModel> Method (TModel, String, array<String )

Updates the specified model instance using values from the controller's current value provider, a prefix, and included properties.

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() _
) As Boolean
'Usage
Dim model As TModel
Dim prefix As String 
Dim includeProperties As String()
Dim returnValue As Boolean 

returnValue = Me.TryUpdateModel(model, _
    prefix, includeProperties)
protected internal bool TryUpdateModel<TModel>(
    TModel model,
    string prefix,
    string[] includeProperties
)
where TModel : class
protected public:
generic<typename TModel>
where TModel : ref class 
bool TryUpdateModel(
    TModel model, 
    String^ prefix, 
    String[]^>^ includeProperties
)
member TryUpdateModel : 
        model:'TModel * 
        prefix:string * 
        includeProperties:string[] -> bool   when 'TModel : not struct
JScript does not support generic types and methods.

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: array<System.String[]

    A list of properties of the model to update.

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 nulla 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.

See Also

Reference

Controller Class

TryUpdateModel Overload

System.Web.Mvc Namespace