DisplayColumnAttribute Classe

Definizione

Spazio dei nomi:

System.ComponentModel.DataAnnotations

Assembly:

System.ComponentModel.Annotations.dll

Source:

DisplayColumnAttribute.cs

Specifica la colonna che viene visualizzata nella tabella a cui viene fatto riferimento come colonna della chiave esterna.

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

Ereditarietà

Object

Attribute

DisplayColumnAttribute

Attributi

AttributeUsageAttribute

Esempio

Nell'esempio seguente viene illustrato l'utilizzo dell'attributo DisplayColumnAttribute. Nell'esempio vengono eseguite le attività seguenti:

• Implementa le classi parziali dei metadati per le tabelle Address e Customer, ovvero tabelle padre per la tabella CustomerAddress.

• Applica l'attributo DisplayColumnAttribute alla Address classe parziale dei metadati per specificare quanto segue:

  • La colonna City della tabella Address (tabella padre) viene visualizzata come colonna chiave esterna nella tabella figlio CustomerAddress.

  • La colonna PostalCode della tabella Address (tabella padre) viene usata per ordinare la casella di selezione Indirizzo nella tabella figlio CustomerAddress.

  • L'ordine di ordinamento è impostato su crescente.

L'esempio applica l'attributo DisplayColumnAttribute alla Customer classe parziale dei metadati per specificare che la colonna LastName in visualizzata come colonna chiave esterna per la tabella 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

Per compilare l'esempio, è necessario quanto segue:

• Qualsiasi edizione di Visual Studio 2010 o successiva.

• Database di esempio AdventureWorksLT. Per informazioni su come scaricare e installare il database di esempio SQL Server, vedere Microsoft SQL Server Product Samples: Database in GitHub. Assicurarsi di installare la versione corretta del database di esempio per la versione di SQL Server in esecuzione.

• Sito Web basato su dati dinamici. In questo modo è possibile creare un contesto di dati per il database e creare la classe contenente il campo dati da personalizzare. Per altre informazioni, vedere Walkthrough: Creating a New Dynamic Data Web Site using Scaffolding.

Commenti

Quando una colonna in una tabella contiene una chiave esterna, Dynamic Data inferisce il valore di visualizzazione per tale colonna dalla tabella a cui viene fatto riferimento. Per impostazione predefinita, viene usata la prima colonna della tabella a cui viene fatto riferimento il cui tipo è stringa (o testo). L'attributo DisplayColumnAttribute consente di modificare questo comportamento predefinito e di specificare una colonna di tabella padre diversa da usare come colonna per il campo chiave esterna.

Quando si applica questo attributo, è necessario rispettare i vincoli di utilizzo seguenti:

• L'attributo può essere applicato solo a una classe.

• L'attributo può essere ereditato da classi derivate.

• L'attributo può essere applicato solo una volta.

Costruttori

DisplayColumnAttribute(String)	Inizializza una nuova istanza della classe DisplayColumnAttribute utilizzando la colonna specificata.
DisplayColumnAttribute(String, String)	Inizializza una nuova istanza della classe DisplayColumnAttribute utilizzando le colonne di visualizzazione e ordinamento specificate.
DisplayColumnAttribute(String, String, Boolean)	Inizializza una nuova istanza della classe DisplayColumnAttribute utilizzando la colonna di visualizzazione, la colonna di ordinamento e l'ordinamento specificati.

Proprietà

DisplayColumn	Ottiene il nome della colonna da utilizzare come campo di visualizzazione.
SortColumn	Ottiene il nome della colonna da utilizzare per l'ordinamento.
SortDescending	Ottiene un valore che indica se applicare un ordinamento crescente o decrescente.
TypeId	Quando è implementata in una classe derivata, ottiene un identificatore univoco della classe Attribute. (Ereditato da Attribute)

Metodi

Equals(Object)	Restituisce un valore che indica se questa istanza è uguale a un oggetto specificato. (Ereditato da Attribute)
GetHashCode()	Restituisce il codice hash per l'istanza. (Ereditato da Attribute)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
IsDefaultAttribute()	In caso di override in una classe derivata, indica se il valore di questa istanza è il valore predefinito per la classe derivata. (Ereditato da Attribute)
Match(Object)	Quando è sottoposto a override in una classe derivata, restituisce un valore che indica se questa istanza equivale a un oggetto specificato. (Ereditato da Attribute)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)