DisplayColumnAttribute Classe

Definição

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 da tabela CustomerAddress.

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

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

  • A coluna PostalCode da tabela Endereço (a tabela pai) é usada para classificar a caixa de 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 seja 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 SQL Server, consulte Microsoft SQL Server Product Samples: Database on GitHub. Instale a versão correta do banco de dados de exemplo para a versão do SQL Server em execução.

• 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.