DisplayColumnAttribute Clase

Definición

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

Herencia

Object

Attribute

DisplayColumnAttribute

Atributos

AttributeUsageAttribute

Ejemplos

En el ejemplo siguiente se muestra cómo usar el DisplayColumnAttribute atributo . En el ejemplo se realizan las siguientes tareas:

• Implementa clases parciales de metadatos para las tablas Address y Customer, que son tablas primarias para la tabla CustomerAddress.

• Aplica el DisplayColumnAttribute atributo a la Address clase parcial de metadatos para especificar lo siguiente:

  • La columna City de la tabla Address (la tabla primaria) se muestra como la columna de clave externa de la tabla secundaria CustomerAddress.

  • La columna PostalCode de la tabla Address (la tabla primaria) se usa para ordenar el cuadro de selección Dirección de la tabla secundaria CustomerAddress.

  • El criterio de ordenación se establece en ascendente.

En el ejemplo se aplica el DisplayColumnAttribute atributo a la Customer clase parcial de metadatos para especificar que la columna LastName de se muestra como columna de clave externa para la tabla 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 el ejemplo, necesita lo siguiente:

• Cualquier edición de Visual Studio 2010 o posterior.

• Base de datos de ejemplo AdventureWorksLT. Para obtener información sobre cómo descargar e instalar la base de datos de ejemplo de SQL Server, vea Microsoft SQL Server Product Samples: Database on GitHub. Asegúrese de instalar la versión correcta de la base de datos de ejemplo para la versión de SQL Server que está ejecutando.

• Un sitio web dinámico controlado por datos. Esto le permite crear un contexto de datos para la base de datos y crear la clase que contiene el campo de datos que se va a personalizar. Para obtener más información, consulte Walkthrough: Creating a New Dynamic Data Web Site using Scaffolding.

Comentarios

Cuando una columna de una tabla contiene una clave externa, los datos dinámicos deducen el valor para mostrar de esa columna de la tabla a la que se hace referencia. De forma predeterminada, se usa la primera columna de la tabla a la que se hace referencia cuyo tipo es cadena (o texto). El DisplayColumnAttribute atributo permite cambiar este comportamiento predeterminado y especificar una columna de tabla primaria diferente que se usará como columna para el campo de clave externa.

Al aplicar este atributo, debe cumplir las siguientes restricciones de uso:

• El atributo solo se puede aplicar a una clase .

• Las clases derivadas pueden heredar el atributo .

• El atributo solo se puede aplicar una vez.