ModelMetadata 類別

定義

命名空間:
System.Web.ModelBinding
組件:
System.Web.dll

提供模型的元資料容器。

public ref class ModelMetadata
public class ModelMetadata
type ModelMetadata = class
Public Class ModelMetadata
繼承
Object
ModelMetadata
衍生

備註

「 模型 」一詞在本類別的語境中用法與其他地方不同。 在 ASP.NET Web Forms應用程式中，資料綁定控制項的 ModelType 屬性指定該資料控制所綁定的資料元素類型。 這種類型通常稱為模型，通常對應於資料庫資料表中的一列。 模型的性質通常對應於表格的欄位。

物件 ModelMetadata 可以提供模型本身、模型屬性，或複雜屬性屬性的元資料。 當物件 ModelMetadata 與某個屬性相關時， 模型 一詞指的是該屬性，容器 一詞則 指該模型。

例如，模型可能是 Contact，具有 Name 和 Age 屬性，而 Name 屬性則可能是由 FirstName 和 LastName 組成的複雜屬性。 當物件 ModelMetadata 與 Contact 物件相關時，模型類型為 Contact 且沒有容器。 當物件 ModelMetadata 涉及 Name 屬性時，模型類型為 Name ，容器類型為 Contact。 當物件 ModelMetadata 涉及 FirstName 屬性時，模型類型為 FirstName ，容器類型為 Name。

建構函式

名稱 Description
ModelMetadata(ModelMetadataProvider, Type, Func<Object>, Type, String)

初始化 ModelMetadata 類別的新執行個體。

欄位

名稱 Description
DefaultOrder

一個整數值，且總是設定為 10000。

屬性

名稱 Description
AdditionalValues

會取得包含模型額外元資料的集合。
ContainerType

了解貨櫃的種類。
ConvertEmptyStringToNull

取得或設定一個值，決定在表單中提交的空字串是否應轉換為 null。
DataTypeName

取得或設定資料型別的名稱。
Description

取得或設定描述模型的文字。
DisplayFormatString

會取得或設定一個格式字串，當模型以顯示模式（而非編輯模式）顯示時應套用該字串。
DisplayName

當模型名稱顯示時，會取得或設定文字在 UI 中使用。
EditFormatString

取得或設定格式字串，在編輯模式下用於 UI 使用。
HideSurroundingHtml

取得或設定一個值，決定周圍的 HTML 是否應該被隱藏。
IsComplexType

會得到一個值，指定該模型是否為複數型態。
IsNullableValueType

會得到一個指定模型是否為可空值型別的值。
IsReadOnly

取得或設定一個值，指定模型是否可更新。
IsRequired

取得或設定一個值，指定該屬性是否被要求。
Model

取得或設定模型物件。
ModelType

了解模型的類型。
NullDisplayText

取得當模型為 null時應該顯示的字串。
Order

取得或設定一個整數，表示該性質相對於其他性質的顯示順序。
Properties

取得一組描述模型屬性的模型元資料物件。
PropertyName

會知道該物業的名稱。
Provider

取得或設定這些元資料的提供者物件。
RequestValidationEnabled

取得或設定一個值，指定是否啟用請求驗證。
ShortDisplayName

取得或設定顯示名稱的簡短版本。
ShowForDisplay

取得或設定一個值，指定模型是否應該以顯示模式（而非編輯模式）在使用者介面中顯示。
ShowForEdit

取得或設定一個值，指定屬性是否應該以編輯模式（而非顯示模式）顯示。
SimpleDisplayText

當模型代表複雜物件時，會取得或設定文字顯示給模型。
TemplateHint

會取得或設定一個值，指示模型在使用者介面中應該使用哪個範本（資料控制）。
Watermark

為文字框取得或設定浮水印文字。

方法

名稱 Description
Equals(Object)

判斷指定的 物件是否等於目前的物件。

(繼承來源 Object)
GetDisplayName()

回傳文字，讓它在 UI 中顯示為模型名稱。
GetHashCode()

做為預設雜湊函式。

(繼承來源 Object)
GetSimpleDisplayText()

當模型代表複雜物件時，回傳文字以顯示模型。
GetType()

取得目前實例的 Type。

(繼承來源 Object)
GetValidators(ModelBindingExecutionContext)

回傳一組適用於模型的驗證者。
MemberwiseClone()

建立目前 Object的淺層複本。

(繼承來源 Object)
ToString()

傳回表示目前 物件的字串。

(繼承來源 Object)

適用於