DisplayColumnAttribute 類別

定義

命名空間:

System.ComponentModel.DataAnnotations

組件:

System.ComponentModel.Annotations.dll

組件:

System.ComponentModel.Annotations.dll, System.ComponentModel.DataAnnotations.dll

組件:

System.ComponentModel.DataAnnotations.dll

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

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)

明確介面實作

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	將一組名稱對應至一組對應的分派識別項 (Dispatch Identifier)。 (繼承來源 Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	擷取物件的類型資訊，可以用來取得介面的類型資訊。 (繼承來源 Attribute)
_Attribute.GetTypeInfoCount(UInt32)	擷取物件提供的類型資訊介面數目 (0 或 1)。 (繼承來源 Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	提供物件所公開的屬性和方法的存取權。 (繼承來源 Attribute)