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

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

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

  • 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 サンプル データベースをダウンロードしてインストールする方法については、GitHubの「Microsoft SQL Server 製品サンプル: データベースを参照してください。 実行しているSQL Serverのバージョンに合った正しいバージョンのサンプル データベースがインストールされていることを確認します。

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

注釈

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

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

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

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

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