DisplayColumnAttribute Classe

Definição

Namespace:

System.ComponentModel.DataAnnotations

Assembly:

System.ComponentModel.Annotations.dll

Origem:

DisplayColumnAttribute.cs

Especifica a coluna que é exibida na tabela referida como uma coluna de chave estrangeira.

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

Herança

Object

Attribute

DisplayColumnAttribute

Atributos

AttributeUsageAttribute

Exemplos

O exemplo a seguir mostra como usar o DisplayColumnAttribute atributo . O exemplo executa as seguintes tarefas:

• Implementa classes parciais de metadados para as tabelas Endereço e Cliente, que são tabelas pai para a tabela CustomerAddress.

• Aplica o DisplayColumnAttribute atributo à Address classe parcial de metadados para especificar o seguinte:

  • A coluna Cidade da tabela Address (a tabela pai) é exibida como a coluna de chave estrangeira na tabela filho CustomerAddress.

  • A coluna PostalCode da tabela Address (a tabela pai) é usada para classificar a caixa seleção Endereço na tabela filho CustomerAddress.

  • A ordem de classificação é definida como crescente.

O exemplo aplica o DisplayColumnAttribute atributo à Customer classe parcial de metadados para especificar que a coluna LastName em foi exibida como a coluna de chave estrangeira para a tabela 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

Para compilar o exemplo, você precisa do seguinte:

• Qualquer edição do Visual Studio 2010 ou posterior.

• O banco de dados de exemplo AdventureWorksLT. Para obter informações sobre como baixar e instalar o banco de dados de exemplo do SQL Server, consulte Exemplos de produto do Microsoft SQL Server: Banco de dados no GitHub. Instale a versão correta do banco de dados de exemplo para a versão do SQL Server que você está executando.

• Um site dinâmico controlado por dados. Isso permite que você crie um contexto de dados para o banco de dados e crie a classe que contém o campo de dados a ser personalizado. Para obter mais informações, consulte Walkthrough: Creating a New Dynamic Data Web Site using Scaffolding.

Comentários

Quando uma coluna em uma tabela contém uma chave estrangeira, dados dinâmicos inferem o valor de exibição dessa coluna da tabela referenciada. Por padrão, a primeira coluna da tabela referenciada cujo tipo é cadeia de caracteres (ou texto) é usada. O DisplayColumnAttribute atributo permite que você altere esse comportamento padrão e especifique uma coluna de tabela pai diferente a ser usada como a coluna para o campo de chave estrangeira.

Ao aplicar esse atributo, você deve aderir às seguintes restrições de uso:

• O atributo só pode ser aplicado a uma classe.

• O atributo pode ser herdado por classes derivadas.

• O atributo pode ser aplicado apenas uma vez.

Construtores

DisplayColumnAttribute(String)	Inicializa uma nova instância da classe DisplayColumnAttribute, usando a coluna especificada.
DisplayColumnAttribute(String, String)	Inicializa uma nova instância da classe DisplayColumnAttribute usando as colunas de classificação e de exibição especificadas.
DisplayColumnAttribute(String, String, Boolean)	Inicializa uma nova instância da classe DisplayColumnAttribute usando a coluna de exibição, a coluna de classificação e a ordem de classificação especificadas.

Propriedades

DisplayColumn	Obtém o nome da coluna a ser usado como o campo de exibição.
SortColumn	Obtém o nome da coluna a ser usada para classificação.
SortDescending	Obtém um valor que indica se deve classificar em ordem crescente ou decrescente.
TypeId	Quando implementado em uma classe derivada, obtém um identificador exclusivo para este Attribute. (Herdado de Attribute)

Métodos

Equals(Object)	Retorna um valor que indica se essa instância é igual a um objeto especificado. (Herdado de Attribute)
GetHashCode()	Retorna o código hash para a instância. (Herdado de Attribute)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
IsDefaultAttribute()	Quando substituído em uma classe derivada, indica se o valor dessa instância é o valor padrão para a classe derivada. (Herdado de Attribute)
Match(Object)	Quando substituído em uma classe derivada, retorna um valor que indica se essa instância é igual a um objeto especificado. (Herdado de Attribute)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)