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 属性を使用する方法を次のコード例に示します。 この例では、次のタスクを実行します。

• CustomerAddress テーブルの親テーブルである Address テーブルと Customer テーブルのメタデータ部分クラスを実装します。

• 属性を DisplayColumnAttribute メタデータ部分クラスに Address 適用して、次を指定します。

  • Address テーブル (親テーブル) の City 列は、CustomerAddress 子テーブルの外部キー列として表示されます。

  • Address テーブル (親テーブル) の 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のバージョンに適したバージョンのサンプル データベースがインストールされていることを確認します。

• 動的なデータ ドリブン Web サイト。 これにより、データベースのデータ コンテキストを作成し、カスタマイズするデータ フィールドを含むクラスを作成できます。 詳細については、「Walkthrough: Creating a New Dynamic Data Web Site using Scaffolding」を参照してください。

注釈

テーブル内の列に外部キーが含まれている場合、動的データは参照先テーブルからその列の表示値を推論します。 既定では、型が string (または text) の参照先テーブルの最初の列が使用されます。 DisplayColumnAttribute属性を使用すると、この既定の動作を変更し、外部キー フィールドの列として使用する別の親テーブル列を指定できます。

この属性を適用する場合は、次の使用制約に従う必要があります。

• 属性は、クラスにのみ適用できます。

• 属性は、派生クラスによって継承できます。

• 属性は 1 回だけ適用できます。

コンストラクター

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)