DisplayColumnAttribute Classe

Definizione

Spazio dei nomi:

System.ComponentModel.DataAnnotations

Assembly:

System.ComponentModel.Annotations.dll

Assembly:

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

Assembly:

System.ComponentModel.DataAnnotations.dll

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 le 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 utilizzata per ordinare la casella di selezione Indirizzo nella tabella figlio CustomerAddress.

  • L'ordinamento è impostato su crescente.

Nell'esempio viene applicato 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 versione 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 on GitHub. Assicurarsi di installare la versione corretta del database di esempio per la versione di SQL Server in esecuzione.

• Sito Web basato sui dati dinamico. In questo modo è possibile creare un contesto 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 deduce il valore di visualizzazione per tale colonna dalla tabella a cui si fa riferimento. Per impostazione predefinita, viene utilizzata la prima colonna della tabella a cui si fa 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 utilizzare 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 dalle classi derivate.

• L'attributo può essere applicato una sola 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)

Implementazioni dell'interfaccia esplicita

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Esegue il mapping di un set di nomi a un set corrispondente di ID dispatch. (Ereditato da Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Recupera le informazioni sul tipo relative a un oggetto, che possono essere usate per ottenere informazioni sul tipo relative a un'interfaccia. (Ereditato da Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Recupera il numero delle interfacce di informazioni sul tipo fornite da un oggetto (0 o 1). (Ereditato da Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Fornisce l'accesso a proprietà e metodi esposti da un oggetto. (Ereditato da Attribute)