DisplayColumnAttribute 類別

定義

命名空間:

System.ComponentModel.DataAnnotations

組件:

System.ComponentModel.Annotations.dll

來源:

DisplayColumnAttribute.cs

將所參考資料表中顯示的資料行指定為外部索引鍵資料行。

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 屬性。 此範例會執行下列工作：

• 實作 Address 和 Customer 數據表的元數據部分類別，這些數據表是 CustomerAddress 數據表的父數據表。

• 將 DisplayColumnAttribute 屬性套用至 Address 元資料部分類別，以指定下列專案：

  • Address 資料表 (父數據表) 的 City 數據行會顯示為 CustomerAddress 子數據表中的外鍵數據行。

  • [位址] 資料表中的 PostalCode 數據行 (父數據表) 用於排序 CustomerAddress 子數據表中的 [位址] 選取方塊。

  • 排序順序會設定為遞增。

此範例會將 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 範例資料庫的資訊，請參閱 Microsoft SQL Server 產品範例：GitHub 上的資料庫。 請確定您為所執行 SQL Server 版本安裝正確的範例資料庫版本。

• 動態數據驅動網站。 這可讓您建立資料庫的數據內容，並建立包含要自定義之數據欄位的類別。 如需詳細資訊，請參閱Walkthrough: Creating a New Dynamic Data Web Site using Scaffolding。

備註

當數據表中的數據行包含外鍵時，動態數據會從參考數據表推斷該數據行的顯示值。 根據預設，會使用類型為字串 (或文字) 之參考數據表的第一個數據行。 屬性 DisplayColumnAttribute 可讓您變更此預設行為，並指定要作為外鍵字段之數據行的不同父數據表數據行。

當您套用此屬性時，必須遵守下列使用條件約束：

• 屬性只能套用至類別。

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

• 屬性只能套用一次。

建構函式

DisplayColumnAttribute(String)	使用指定的資料行，初始化 DisplayColumnAttribute 類別的新執行個體。
DisplayColumnAttribute(String, String)	使用指定的顯示和排序資料行，初始化 DisplayColumnAttribute 類別的新執行個體。
DisplayColumnAttribute(String, String, Boolean)	使用指定的顯示資料行，以及指定的排序資料行和排序次序，初始化 DisplayColumnAttribute 類別的新執行個體。

屬性

DisplayColumn	取得用來做為顯示欄位的資料行名稱。
SortColumn	取得用於排序的資料行名稱。
SortDescending	取得值，這個值指出要依遞減或遞增次序排序。
TypeId	在衍生類別中實作時，取得這個 Attribute 的唯一識別碼。 (繼承來源 Attribute)

方法

Equals(Object)	傳回值，這個值指出此執行個體是否與指定的物件相等。 (繼承來源 Attribute)
GetHashCode()	傳回這個執行個體的雜湊碼。 (繼承來源 Attribute)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
IsDefaultAttribute()	在衍生類別中覆寫時，表示這個執行個體的值是衍生類別的預設值。 (繼承來源 Attribute)
Match(Object)	在衍生類別中覆寫時，會傳回值，表示這個執行個體是否等於指定物件。 (繼承來源 Attribute)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)