ModelMetadata Class

Definition

Provides a container for metadata for a model.

C#
public class ModelMetadata
Inheritance
ModelMetadata
Derived

Remarks

The word model is used differently in the context of this class than it is typically used elsewhere. In an ASP.NET Web Forms application, the ModelType attribute of a data-bound control specifies the type of a data element that the data control is bound to. This type is typically referred to as the model, and it typically corresponds to a row in a database table. The properties of the model typically correspond to columns of the table.

A ModelMetadata object can provide metadata for the model itself or for a property of the model, or for a property of a complex property. When the ModelMetadata object pertains to a property, the word model refers to the property, and the word container refers to the model.

For example, the model might be Contact, which has Name and Age properties, and the Name property might be a complex property composed of FirstName and LastName. When the ModelMetadata object pertains to the Contact object, the model type is Contact and there is no container. When the ModelMetadata object pertains to the Name property, the model type is Name and the container type is Contact. When the ModelMetadata object pertains to the FirstName property, the model type is FirstName and the container type is Name.

Constructors

Fields

DefaultOrder

An integer value that is always set to 10000.

Properties

AdditionalValues

Gets a collection that contains additional metadata about the model.

ContainerType

Gets the type of the container.

ConvertEmptyStringToNull

Gets or sets a value that determines whether empty strings that are submitted in forms should be converted to null.

DataTypeName

Gets or sets the name of the data type.

Description

Gets or sets text that describes the model.

DisplayFormatString

Gets or sets a format string that should be applied when the model is displayed in display mode (as opposed to in edit mode).

DisplayName

Gets or sets the text to use in UI when the name of the model is displayed.

EditFormatString

Gets or sets the format string to use in UI in edit mode.

HideSurroundingHtml

Gets or sets a value that determines whether surrounding HTML should be hidden.

IsComplexType

Gets a value that specifies whether the model is a complex type.

IsNullableValueType

Gets a value that specifies whether the model is a nullable value type.

IsReadOnly

Gets or sets a value that specifies whether the model can be updated.

IsRequired

Gets or sets a value that specifies whether the property is required.

Model

Gets or sets the model object.

ModelType

Gets the type of the model.

NullDisplayText

Gets the string that should be displayed when the model is null.

Order

Gets or sets an integer that indicates the order in which to display this property relative to other properties.

Properties

Gets a collection of model metadata objects that describe the properties of the model.

PropertyName

Gets the name of the property.

Provider

Gets or sets the provider object for this metadata.

RequestValidationEnabled

Gets or sets a value that specifies whether request validation is enabled.

ShortDisplayName

Gets or sets a short version of the display name.

ShowForDisplay

Gets or sets a value that specifies whether the model should be displayed in the UI in display mode (as opposed to edit mode).

ShowForEdit

Gets or sets a value that specifies whether the property should be displayed in edit mode (as opposed to display mode).

SimpleDisplayText

Gets or sets text to display for the model when the model represents a complex object.

TemplateHint

Gets or sets a value that indicates what template (data control) should be used in UI for the model.

Watermark

Gets or sets watermark text for a text box.

Methods

Equals(Object)

Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetDisplayName()

Returns text to display as the name of the model in UI.

GetHashCode()

Serves as the default hash function.

(Inherited from Object)
GetSimpleDisplayText()

Returns text to display for the model when the model represents a complex object.

GetType()

Gets the Type of the current instance.

(Inherited from Object)
GetValidators(ModelBindingExecutionContext)

Returns a collection of validators that apply to the model.

MemberwiseClone()

Creates a shallow copy of the current Object.

(Inherited from Object)
ToString()

Returns a string that represents the current object.

(Inherited from Object)

Applies to

Product Versions
.NET Framework 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1