DisplayColumnAttribute 類別

定義

public ref class DisplayColumnAttribute : Attribute

[System.AttributeUsage(System.AttributeTargets.Class, AllowMultiple=false, Inherited=true)]
public class DisplayColumnAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Class, AllowMultiple=false, Inherited=true)>]
type DisplayColumnAttribute = class
    inherit Attribute

Public Class DisplayColumnAttribute
Inherits Attribute

繼承

Object

Attribute

DisplayColumnAttribute

屬性

AttributeUsageAttribute

範例

以下範例說明如何使用該 DisplayColumnAttribute 屬性。 此範例會執行下列工作：

• 為地址資料表與客戶資料表實作元資料部分類別，這些資料表是客戶地址資料表的父資料表。

• 將屬性 DisplayColumnAttribute 套用到 Address 元資料部分類別以指定以下內容：

  • 地址表（父表）中的城市欄位會以 CustomerAddress 子資料表中的外鍵欄位顯示。

  • Address 表（父表）中的 PostalCode 欄位用於排序 CustomerAddress 子表中的 Address 選擇框。

  • 排序順序設定為升序。

範例中將屬性 DisplayColumnAttribute 套用於 Customer 元資料部分類別，指定 LastName 欄位作為 CustomerAddress 資料表的外鍵欄位。

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

[DisplayColumn("City", "PostalCode", false)]
public partial class Address
{
}

[DisplayColumn("LastName")]
public partial class Customer
{
}

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

<DisplayColumn("City", "PostalCode", False)> _
Partial Public Class Address

End Class

<DisplayColumn("LastName")> _
Public Partial Class Customer

End Class

要編譯範例，你需要以下資料：

• 任何版本的 Visual Studio 2010 或更新版本。

• AdventureWorksLT 範例資料庫。 如需下載及安裝SQL Server樣本資料庫，請參閱GitHubMicrosoft SQL Server產品樣本：資料庫。 確保你安裝的是與你所使用的 SQL Server 版本相符的範例資料庫版本。

• 一個動態、數據驅動的網站。 這讓你能為資料庫建立資料上下文，並建立包含資料欄位的類別以便自訂。 如需詳細資訊，請參閱Walkthrough: Creating a New Dynamic Data Web Site using Scaffolding。

備註

當資料表中的欄位包含外鍵時，動態資料會從該欄位的顯示值從參考資料表中推斷出。 預設情況下，會使用被參考資料表中類型為字串（或文字）的第一欄。 屬性 DisplayColumnAttribute 允許你改變這個預設行為，並指定另一個父表欄位作為外鍵欄位的欄位。

套用此屬性時，必須遵守以下使用限制：

• 該屬性只能套用到類別上。

• 屬性可由衍生類別繼承。

• 該屬性只能套用一次。