DisplayColumnAttribute Clase

Definición

Espacio de nombres:

System.ComponentModel.DataAnnotations

Ensamblado:

System.ComponentModel.Annotations.dll

Ensamblados:

System.ComponentModel.Annotations.dll, System.ComponentModel.DataAnnotations.dll

Ensamblado:

System.ComponentModel.DataAnnotations.dll

Especifica la columna que se muestra en la tabla a la que se hizo referencia como una columna de clave externa.

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 utilizar el atributo DisplayColumnAttribute. 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 en 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 en 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.

• La 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 ejemplos de productos Microsoft SQL Server: base de datos en 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, vea 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.

Constructores

DisplayColumnAttribute(String)	Inicializa una nueva instancia de la clase DisplayColumnAttribute utilizando la columna especificada.
DisplayColumnAttribute(String, String)	Inicializa una nueva instancia de la clase DisplayColumnAttribute utilizando las columnas de presentación y ordenación especificadas.
DisplayColumnAttribute(String, String, Boolean)	Inicializa una nueva instancia de la clase DisplayColumnAttribute utilizando la columna de presentación y la columna de ordenación especificadas y el criterio de ordenación especificado.

Propiedades

DisplayColumn	Obtiene el nombre de la columna que debe usarse como campo de presentación.
SortColumn	Obtiene el nombre de la columna que va a utilizarse para la ordenación.
SortDescending	Obtiene un valor que indica si la ordenación debe realizarse en sentido ascendente o descendente.
TypeId	Cuando se implementa en una clase derivada, obtiene un identificador único para este Attribute. (Heredado de Attribute)

Métodos

Equals(Object)	Devuelve un valor que indica si esta instancia es igual que un objeto especificado. (Heredado de Attribute)
GetHashCode()	Devuelve el código hash de esta instancia. (Heredado de Attribute)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
IsDefaultAttribute()	Si se reemplaza en una clase derivada, indica si el valor de esta instancia es el valor predeterminado de la clase derivada. (Heredado de Attribute)
Match(Object)	Cuando se invalida en una clase derivada, devuelve un valor que indica si esta instancia es igual a un objeto especificado. (Heredado de Attribute)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Implementaciones de interfaz explícitas

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Asigna un conjunto de nombres a un conjunto correspondiente de identificadores de envío. (Heredado de Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Obtiene la información de tipos de un objeto, que puede utilizarse para obtener la información de tipos de una interfaz. (Heredado de Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Recupera el número de interfaces de información de tipo que proporciona un objeto (0 ó 1). (Heredado de Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Proporciona acceso a las propiedades y los métodos expuestos por un objeto. (Heredado de Attribute)