DisplayExtensions.DisplayFor<TModel, TValue> Method (HtmlHelper<TModel>, Expression<Func<TModel, TValue>>)

Returns HTML markup for each property in the object that is represented by the Expression expression.

Namespace:  System.Web.Mvc.Html
Assembly:  System.Web.Mvc (in System.Web.Mvc.dll)

Syntax

'Declaration
<ExtensionAttribute> _
Public Shared Function DisplayFor(Of TModel, TValue) ( _
    html As HtmlHelper(Of TModel), _
    expression As Expression(Of Func(Of TModel, TValue)) _
) As MvcHtmlString
'Usage
Dim html As HtmlHelper(Of TModel)
Dim expression As Expression(Of Func(Of TModel, TValue))
Dim returnValue As MvcHtmlString

returnValue = html.DisplayFor(expression)
public static MvcHtmlString DisplayFor<TModel, TValue>(
    this HtmlHelper<TModel> html,
    Expression<Func<TModel, TValue>> expression
)
[ExtensionAttribute]
public:
generic<typename TModel, typename TValue>
static MvcHtmlString^ DisplayFor(
    HtmlHelper<TModel>^ html, 
    Expression<Func<TModel, TValue>^>^ expression
)
JScript does not support generic types or methods.

Type Parameters

  • TModel
    The type of the model.
  • TValue
    The type of the value.

Parameters

Return Value

Type: System.Web.Mvc.MvcHtmlString
The HTML markup for each property in the object that is represented by the expression.

Usage Note

In Visual Basic and C#, you can call this method as an instance method on any object of type HtmlHelper<TModel>. When you use instance method syntax to call this method, omit the first parameter. For more information, see b8020aae-374d-46a9-bcb7-8cc2390b93b6 or 175ce3ff-9bbf-4e64-8421-faeb81a0bb51.

Remarks

This method is typically used to display values from the object that is exposed by the Model property. For more information about the differences between this method and the other Display methods, see the DisplayExtensions class overview.

This method generates different HTML markup depending on the data type of the property that is being rendered, and according to whether the property is marked with certain attributes. The method renders markup according to the following rules:

  • If the property is typed as a primitive type (integer, string, and so on), the method renders a string that represents the property value.

  • If the property type is Boolean, the method renders an HTML input element for a check box. For example, a Boolean property named Enabled might render markup such as the following:

    <input class="check-box"

    disabled="disabled"

    type="checkbox"

    checked="checked" />

  • If a property is annotated with a data type attribute, the attribute specifies the markup that is generated for the property. For example, if the property is marked with the EmailAddress attribute, the method generates markup that contains an HTML anchor that is configured with the mailto protocol, as in the following example:

    <a href='mailto:joe@contoso.com'>joe@contoso.com\</a>

  • If the object contains multiple properties, for each property the method generates a string that consists of markup for the property name and markup for the property value.

Examples

A Visual Studio project with source code is available to accompany this topic: Download.

See Also

Reference

DisplayExtensions Class

DisplayFor Overload

System.Web.Mvc.Html Namespace

Other Resources

Walkthrough: Using Templated Helpers to Display Data in ASP.NET MVC