DisplayColumnAttribute Klasa

Definicja

Przestrzeń nazw:

System.ComponentModel.DataAnnotations

Zestaw:

System.ComponentModel.Annotations.dll

Źródło:

DisplayColumnAttribute.cs

Określa kolumnę wyświetlaną w tabeli określanej jako kolumna klucza obcego.

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

Dziedziczenie

Object

Attribute

DisplayColumnAttribute

Atrybuty

AttributeUsageAttribute

Przykłady

W poniższym przykładzie pokazano, jak używać atrybutu DisplayColumnAttribute . W przykładzie są wykonywane następujące zadania:

• Implementuje klasy częściowe metadanych dla tabel Address (Adres) i Customer (Klient), które są tabelami nadrzędnymi tabeli CustomerAddress.

• DisplayColumnAttribute Stosuje atrybut do Address klasy częściowej metadanych, aby określić następujące elementy:

  • Kolumna City (Miasto) z tabeli Address (tabela nadrzędna) jest wyświetlana jako kolumna klucza obcego w tabeli podrzędnej CustomerAddress.

  • Kolumna PostalCode z tabeli Address (tabela nadrzędna) służy do sortowania pola wyboru Adres w tabeli podrzędnej CustomerAddress.

  • Kolejność sortowania jest ustawiona na rosnąco.

Przykład stosuje DisplayColumnAttribute atrybut do Customer klasy częściowej metadanych, aby określić, że kolumna LastName wyświetlana jako kolumna klucza obcego dla tabeli 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

Aby skompilować przykład, potrzebne są następujące elementy:

• Dowolna wersja programu Visual Studio 2010 lub nowszego.

• Przykładowa baza danych AdventureWorksLT. Aby uzyskać informacje na temat pobierania i instalowania przykładowej bazy danych SQL Server, zobacz Przykłady produktów Microsoft SQL Server: Database on GitHub. Upewnij się, że zainstalowano poprawną wersję przykładowej bazy danych dla wersji SQL Server, która jest uruchomiona.

• Dynamiczna witryna internetowa oparta na danych. Dzięki temu można utworzyć kontekst danych dla bazy danych i utworzyć klasę zawierającą pole danych do dostosowania. Aby uzyskać więcej informacji, zobacz Walkthrough: Creating a New Dynamic Data Web Site using Scaffolding.

Uwagi

Gdy kolumna w tabeli zawiera klucz obcy, dynamiczne dane wywnioskuje wartość wyświetlaną dla tej kolumny z tabeli, do których odwołuje się odwołanie. Domyślnie jest używana pierwsza kolumna tabeli, której typem jest ciąg (lub tekst). Atrybut DisplayColumnAttribute umożliwia zmianę tego domyślnego zachowania i określenie innej nadrzędnej kolumny tabeli do użycia jako kolumny dla pola klucza obcego.

Po zastosowaniu tego atrybutu należy przestrzegać następujących ograniczeń użycia:

• Atrybut można zastosować tylko do klasy.

• Atrybut może być dziedziczony przez klasy pochodne.

• Atrybut można zastosować tylko raz.

Konstruktory

DisplayColumnAttribute(String)	Inicjuje DisplayColumnAttribute nowe wystąpienie klasy przy użyciu określonej kolumny.
DisplayColumnAttribute(String, String)	Inicjuje DisplayColumnAttribute nowe wystąpienie klasy przy użyciu określonych kolumn wyświetlania i sortowania.
DisplayColumnAttribute(String, String, Boolean)	Inicjuje DisplayColumnAttribute nowe wystąpienie klasy przy użyciu określonej kolumny wyświetlania oraz określonej kolumny sortowania i kolejności sortowania.

Właściwości

DisplayColumn	Pobiera nazwę kolumny do użycia jako pole wyświetlania.
SortColumn	Pobiera nazwę kolumny do użycia do sortowania.
SortDescending	Pobiera wartość wskazującą, czy należy sortować w kolejności malejącej, czy rosnącej.
TypeId	Po zaimplementowaniu w klasie pochodnej pobiera unikatowy identyfikator dla tego Attributeelementu . (Odziedziczone po Attribute)

Metody

Equals(Object)	Zwraca wartość wskazującą, czy to wystąpienie jest równe podanemu obiektowi. (Odziedziczone po Attribute)
GetHashCode()	Zwraca wartość skrótu dla tego wystąpienia. (Odziedziczone po Attribute)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
IsDefaultAttribute()	Podczas zastępowania w klasie pochodnej wskazuje, czy wartość tego wystąpienia jest wartością domyślną dla klasy pochodnej. (Odziedziczone po Attribute)
Match(Object)	Po przesłonięciu w klasie pochodnej zwraca wartość wskazującą, czy to wystąpienie jest równe określonemu obiektowi. (Odziedziczone po Attribute)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)