DisplayColumnAttribute Classe

Définition

Espace de noms:

System.ComponentModel.DataAnnotations

Assembly:

System.ComponentModel.Annotations.dll

Source:

DisplayColumnAttribute.cs

Spécifie la colonne qui s'affiche dans la table désignée comme colonne de clé étrangère.

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

Héritage

Object

Attribute

DisplayColumnAttribute

Attributs

AttributeUsageAttribute

Exemples

L'exemple suivant montre comment utiliser l'attribut DisplayColumnAttribute. L’exemple effectue les tâches suivantes :

• Implémente des classes partielles de métadonnées pour les tables Address et Customer, qui sont des tables parentes pour la table CustomerAddress.

• Applique l’attribut DisplayColumnAttribute à la Address classe partielle de métadonnées pour spécifier les éléments suivants :

  • La colonne City de la table Address (la table parente) s’affiche en tant que colonne clé étrangère dans la table enfant CustomerAddress.

  • La colonne PostalCode de la table Address (la table parente) est utilisée pour trier la zone de sélection Adresse dans la table enfant CustomerAddress.

  • L’ordre de tri est défini sur croissant.

L’exemple applique l’attribut DisplayColumnAttribute à la Customer classe partielle de métadonnées pour spécifier que la colonne LastName dans est affichée en tant que colonne de clé étrangère pour la table 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

Pour compiler l’exemple, vous avez besoin des éléments suivants :

• Toute édition de Visual Studio 2010 ou version ultérieure.

• Exemple de base de données AdventureWorksLT. Pour plus d’informations sur le téléchargement et l’installation de l’exemple de base de données SQL Server, consultez Microsoft SQL Server Product Samples : Database on GitHub. Veillez à installer la version correcte de l’exemple de base de données pour la version de SQL Server que vous exécutez.

• Site Web dynamique piloté par les données. Cela vous permet de créer un contexte de données pour la base de données et de créer la classe qui contient le champ de données à personnaliser. Pour plus d'informations, consultez Walkthrough: Creating a New Dynamic Data Web Site using Scaffolding.

Remarques

Lorsqu’une colonne d’une table contient une clé étrangère, Dynamic Data déduit la valeur d’affichage de cette colonne à partir de la table référencée. Par défaut, la première colonne de la table référencée dont le type est chaîne (ou texte) est utilisée. L’attribut DisplayColumnAttribute vous permet de modifier ce comportement par défaut et de spécifier une autre colonne de table parente à utiliser comme colonne pour le champ de clé étrangère.

Lorsque vous appliquez cet attribut, vous devez respecter les contraintes d’utilisation suivantes :

• L’attribut ne peut être appliqué qu’à une classe .

• L’attribut peut être hérité par les classes dérivées.

• L’attribut ne peut être appliqué qu’une seule fois.

Constructeurs

DisplayColumnAttribute(String)	Initialise une nouvelle instance de la classe DisplayColumnAttribute à l'aide de la colonne spécifiée.
DisplayColumnAttribute(String, String)	Initialise une nouvelle instance de la classe DisplayColumnAttribute en utilisant les colonnes de tri et d'affichage spécifiées.
DisplayColumnAttribute(String, String, Boolean)	Initialise une nouvelle instance de la classe DisplayColumnAttribute en utilisant la colonne d'affichage spécifiée et la colonne et l'ordre de tri spécifiés.

Propriétés

DisplayColumn	Obtient le nom de la colonne à utiliser comme champ d'affichage.
SortColumn	Obtient le nom de la colonne à utiliser pour le tri.
SortDescending	Obtient une valeur qui indique s'il faut trier par ordre croissant ou décroissant.
TypeId	Lors de l'implémentation dans une classe dérivée, obtient un identificateur unique pour l'objet Attribute. (Hérité de Attribute)

Méthodes

Equals(Object)	Retourne une valeur qui indique si cette instance est égale à un objet spécifié. (Hérité de Attribute)
GetHashCode()	Retourne le code de hachage de cette instance. (Hérité de Attribute)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
IsDefaultAttribute()	En cas de substitution dans une classe dérivée, indique si la valeur de cette instance est la valeur par défaut pour la classe dérivée. (Hérité de Attribute)
Match(Object)	En cas de substitution dans une classe dérivée, retourne une valeur indiquant si cette instance équivaut à un objet spécifié. (Hérité de Attribute)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)