UIHintAttribute.UIHint 屬性

定義

命名空間:

System.ComponentModel.DataAnnotations

組件:

System.ComponentModel.Annotations.dll

來源:

UIHintAttribute.cs

取得或設定欄位範本名稱，用以顯示資料欄位。

public:
 property System::String ^ UIHint { System::String ^ get(); };

public string UIHint { get; }

member this.UIHint : string

Public ReadOnly Property UIHint As String

屬性值

String

顯示資料欄位的欄位範本名稱。

備註

ASP.NET Dynamic Data 提供欄位範本與頁面範本，用於資料模型中渲染資料欄位。 欄位範本是使用者控制項（.ascx 檔案），會映射到模型中的資料欄位。 你可以修改 Dynamic Data 提供的預設使用者控制項，或是建立自訂的使用者控制項作為欄位範本使用。 如果你建立自訂使用者控制項，你就是在該屬性上使用該 UIHint 屬性，讓該屬性是用自訂使用者控制項來渲染的。 該 UIHint 屬性指定在渲染特定欄位時要使用哪個欄位範本。 該 UIHint 屬性可指向動態資料中提供的範本或自訂範本。 舉例來說，你可以建立一個名為 RedText_Edit.ascx 的自訂欄位範本，然後用這個 UIHint 屬性指定用 RedText_Edit.ascx 控制項來渲染指定的資料欄位，而不是 Dynamic Data 預設的 Text_Edit.ascx 範本。

以下範例說明如何指定資料庫中的 UnitsInStock 欄位將使用指定的自訂欄位範本來渲染。

using System;
using System.Web.DynamicData;
using System.ComponentModel.DataAnnotations;

[MetadataType(typeof(ProductMetadata))]
public partial class Product 
{
}

public partial class ProductMetadata
{
    [UIHint("UnitsInStock")]
    [Range(100, 10000, 
    ErrorMessage = "Units in stock should be between {1} and {2}.")]
    public object UnitsInStock;
}

Imports System.Web.DynamicData
Imports System.ComponentModel.DataAnnotations


<MetadataType(GetType(ProductMetadata))> _
Partial Public Class Product

End Class

Partial Public Class ProductMetadata
    <UIHint("UnitsInStock")> _
    <Range(100, 10000)> _
    Public UnitsInStock As Object
End Class

另請參閱

• ASP.NET 動態資料概述
• 攻略：利用鷹架建立新的動態資料網站