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 seguinte 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 pais para a tabela CustomerAddress.

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

  • A coluna Cidade da tabela de Endereços (a tabela principal) é apresentada como a coluna de chave estrangeira na tabela filha CustomerAddress.

  • A coluna PostalCode da tabela de Endereços (a tabela pai) é usada para ordenar a caixa de seleção de Endereços na tabela filha CustomerAddress.

  • A ordem de ordenação está definida para ascendente.

O exemplo aplica o DisplayColumnAttribute atributo à Customer classe parcial de metadados para especificar que a coluna Último Nome é 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, precisa do seguinte:

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

• A base de dados de exemplos AdventureWorksLT. Para informações sobre como descarregar e instalar a base de dados de exemplos SQL Server, consulte Microsoft SQL Server Product Samples: Database no GitHub. Certifica-te de que instalas a versão correta da base de dados de exemplo para a versão do SQL Server que estás a usar.

• Um site dinâmico orientado por dados. Isto permite-lhe criar um contexto de dados para a base de dados e criar a classe que contém o campo de dados para personalizar. Para obter mais informações, veja Walkthrough: Creating a New Dynamic Data Web Site using Scaffolding.

Observações

Quando uma coluna numa tabela contém uma chave estrangeira, os Dados Dinâmicos inferem o valor de exibição dessa coluna a partir da tabela referenciada. Por defeito, é usada a primeira coluna da tabela referenciada cujo tipo é string (ou texto). O DisplayColumnAttribute atributo permite-lhe alterar este comportamento por defeito e especificar uma coluna de tabela pai diferente para usar como coluna do campo chave estrangeira.

Ao aplicar este atributo, deve cumprir as seguintes restrições de utilização:

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

• O atributo pode ser herdado por classes derivadas.

• O atributo só pode ser aplicado uma vez.