EditorExtensions.EditorForModel Method

 

Returns an HTML input element for each property in the model.

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

NameDescription
System_CAPS_pubmethodSystem_CAPS_staticEditorForModel(HtmlHelper)

Returns an HTML input element for each property in the model.

System_CAPS_pubmethodSystem_CAPS_staticEditorForModel(HtmlHelper, Object)

Returns an HTML input element for each property in the model, using additional view data.

System_CAPS_pubmethodSystem_CAPS_staticEditorForModel(HtmlHelper, String)

Returns an HTML input element for each property in the model, using the specified template.

System_CAPS_pubmethodSystem_CAPS_staticEditorForModel(HtmlHelper, String, Object)

Returns an HTML input element for each property in the model, using the specified template and additional view data.

System_CAPS_pubmethodSystem_CAPS_staticEditorForModel(HtmlHelper, String, String)

Returns an HTML input element for each property in the model, using the specified template name and HTML field name.

System_CAPS_pubmethodSystem_CAPS_staticEditorForModel(HtmlHelper, String, String, Object)

Returns an HTML input element for each property in the model, using the template name, HTML field name, and additional view data.

Return to top

EditorExtensions.EditorForModel Method (HtmlHelper)

Returns an HTML input element for each property in the model.

public static MvcHtmlString EditorForModel(
	this HtmlHelper html
)

Parameters

html
Type: System.Web.Mvc.HtmlHelper

The HTML helper instance that this method extends.

Return Value

Type: System.Web.Mvc.MvcHtmlString

An HTML input element for each property in the model.

Return to top

EditorExtensions.EditorForModel Method (HtmlHelper, Object)

Returns an HTML input element for each property in the model, using additional view data.

public static MvcHtmlString EditorForModel(
	this HtmlHelper html,
	object additionalViewData
)

Parameters

html
Type: System.Web.Mvc.HtmlHelper

The HTML helper instance that this method extends.

additionalViewData
Type: System.Object

An anonymous object that can contain additional view data that will be merged into the ViewDataDictionary<TModel> instance that is created for the template.

Return Value

Type: System.Web.Mvc.MvcHtmlString

An HTML input element for each property in the model.

Return to top

EditorExtensions.EditorForModel Method (HtmlHelper, String)

Returns an HTML input element for each property in the model, using the specified template.

public static MvcHtmlString EditorForModel(
	this HtmlHelper html,
	string templateName
)

Parameters

html
Type: System.Web.Mvc.HtmlHelper

The HTML helper instance that this method extends.

templateName
Type: System.String

The name of the template to use to render the object.

Return Value

Type: System.Web.Mvc.MvcHtmlString

An HTML input element for each property in the model and in the specified template.

If a template whose name matches the templateName parameter is found in the controller's EditorTemplates folder, that template is used to render the model. If a template is not found in the controller's EditorTemplates folder, the Views\Shared\EditorTemplates folder is searched for a template that matches the name of the templateName parameter. If no template is found, the default template is used.

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 an HTML input element for a text box. For example, a property named Height that is typed as a integer might render markup such as the following:

    <input class="text-box single-line"

    id="Height"

    name="Height"

    type="text"

    value="68"

    />

  • If a property is marked with a data-type attribute or a UIHintAttribute attribute, the attribute specifies the markup that is generated for the property. For example, if the property is marked with the MultilineText attribute, the method generates markup for a multi-line text box.

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

Return to top

EditorExtensions.EditorForModel Method (HtmlHelper, String, Object)

Returns an HTML input element for each property in the model, using the specified template and additional view data.

public static MvcHtmlString EditorForModel(
	this HtmlHelper html,
	string templateName,
	object additionalViewData
)

Parameters

html
Type: System.Web.Mvc.HtmlHelper

The HTML helper instance that this method extends.

templateName
Type: System.String

The name of the template to use to render the object.

additionalViewData
Type: System.Object

An anonymous object that can contain additional view data that will be merged into the ViewDataDictionary<TModel> instance that is created for the template.

Return Value

Type: System.Web.Mvc.MvcHtmlString

An HTML input element for each property in the model.

Return to top

EditorExtensions.EditorForModel Method (HtmlHelper, String, String)

Returns an HTML input element for each property in the model, using the specified template name and HTML field name.

public static MvcHtmlString EditorForModel(
	this HtmlHelper html,
	string templateName,
	string htmlFieldName
)

Parameters

html
Type: System.Web.Mvc.HtmlHelper

The HTML helper instance that this method extends.

templateName
Type: System.String

The name of the template to use to render the object.

htmlFieldName
Type: System.String

A string that is used to disambiguate the names of HTML input elements that are rendered for properties that have the same name.

Return Value

Type: System.Web.Mvc.MvcHtmlString

An HTML input element for each property in the model and in the named template.

The htmlFieldName parameter is provided for the case in which all the following are true:

  • A page contains multiple objects to be edited.

  • The action method model binds each object separately.

  • The objects have at least one property that has the same name.

If a template whose name matches the templateName parameter is found in the controller's EditorTemplates folder, that template is used to render the model. If a template is not found in the controller's EditorTemplates folder, the Views\Shared\EditorTemplates folder is searched for a template that matches the name of the templateName parameter. If no template is found, the default template is used.

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 an HTML input element for a text box. For example, a property named Height that is typed as a integer might render markup such as the following:

    <input class="text-box single-line"

    id="Height"

    name="Height"

    type="text"

    value="68"

    />

  • If a property is marked with a data-type attribute or a UIHintAttribute attribute, the attribute specifies the markup that is generated for the property. For example, if the property is marked with the MultilineText attribute, the method generates markup for a multi-line text box.

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

Return to top

EditorExtensions.EditorForModel Method (HtmlHelper, String, String, Object)

Returns an HTML input element for each property in the model, using the template name, HTML field name, and additional view data.

public static MvcHtmlString EditorForModel(
	this HtmlHelper html,
	string templateName,
	string htmlFieldName,
	object additionalViewData
)

Parameters

html
Type: System.Web.Mvc.HtmlHelper

The HTML helper instance that this method extends.

templateName
Type: System.String

The name of the template to use to render the object.

htmlFieldName
Type: System.String

A string that is used to disambiguate the names of HTML input elements that are rendered for properties that have the same name.

additionalViewData
Type: System.Object

An anonymous object that can contain additional view data that will be merged into the ViewDataDictionary<TModel> instance that is created for the template.

Return Value

Type: System.Web.Mvc.MvcHtmlString

An HTML input element for each property in the model.

The htmlFieldName parameter is provided for the case in which all the following are true:

  • A page contains multiple objects to be edited.

  • The action method model binds each object separately.

  • The objects have at least one property that has the same name.

If a template whose name matches the templateName parameter is found in the controller's EditorTemplates folder, that template is used to render the expression. If a template is not found in the controller's EditorTemplates folder, the Views\Shared\EditorTemplates folder is searched for a template that matches the name of the templateName parameter. If no template is found, the default template is used.

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 an HTML input element for a text box. For example, a property named Height that is typed as a integer might render markup such as the following:

    <input class="text-box single-line"

    id="Height"

    name="Height"

    type="text"

    value="68"

    />

  • If a property is marked with a data-type attribute or a UIHintAttribute attribute, the attribute specifies the markup that is generated for the property. For example, if the property is marked with the MultilineText attribute, the method generates markup for a multi-line text box.

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

Return to top
Show: