DisplayColumnAttribute DisplayColumnAttribute DisplayColumnAttribute DisplayColumnAttribute Class

Definizione

Specifica la colonna visualizzata nella tabella a cui si fa riferimento come colonna di chiave esterna.Specifies the column that is displayed in the referred table as a foreign-key column.

public ref class DisplayColumnAttribute : Attribute
[System.AttributeUsage(System.AttributeTargets.Class, AllowMultiple=false, Inherited=true)]
public class DisplayColumnAttribute : Attribute
type DisplayColumnAttribute = class
    inherit Attribute
Public Class DisplayColumnAttribute
Inherits Attribute
Ereditarietà
DisplayColumnAttributeDisplayColumnAttributeDisplayColumnAttributeDisplayColumnAttribute
Attributi

Esempi

Nell'esempio seguente viene illustrato l'utilizzo dell'attributo DisplayColumnAttribute.The following example shows how to use the DisplayColumnAttribute attribute. L'esempio esegue le attività seguenti:The example performs the following tasks:

  • Implementa classi parziali di metadati per le tabelle Customer e indirizzo, ovvero tabelle padre per la tabella CustomerAddress.Implements metadata partial classes for the Address and Customer tables, which are parent tables for the CustomerAddress table.

  • Si applica il DisplayColumnAttribute dell'attributo di Address classe parziale i metadati per specificare quanto segue:Applies the DisplayColumnAttribute attribute to the Address metadata partial class to specify the following:

    • La colonna City dalla tabella degli indirizzi (la tabella padre) viene visualizzata come colonna chiave esterna nella tabella CustomerAddress figlio.The City column from the Address table (the parent table) is displayed as the foreign-key column in the CustomerAddress child table.

    • La colonna PostalCode dalla tabella degli indirizzi (la tabella padre) viene utilizzata per l'ordinamento di casella di selezione dell'indirizzo nella tabella CustomerAddress figlio.The PostalCode column from the Address table (the parent table) is used for sorting the Address selection box in the CustomerAddress child table.

    • L'ordinamento è crescente.The sort order is set to ascending.

Nell'esempio viene applicato il DisplayColumnAttribute dell'attributo di Customer classe parziale i metadati per specificare che la colonna LastName in visualizzato come colonna chiave esterna per la tabella CustomerAddress.The example applies the DisplayColumnAttribute attribute to the Customer metadata partial class to specify that the LastName column in displayed as the foreign-key column for the CustomerAddress table.

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
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:To compile the example, you need the following:

  • Qualsiasi edizione di Visual Studio 2010 o versione successiva.Any edition of Visual Studio 2010 or later.

  • Il database di esempio AdventureWorksLT.The AdventureWorksLT sample database. Per informazioni su come scaricare e installare il database di esempio di SQL Server, vedere Microsoft SQL Server Product Samples: Database su GitHub.For information about how to download and install the SQL Server sample database, see 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.Make sure that you install the correct version of the sample database for the version of SQL Server that you are running.

  • Dinamico basati sui dati sito Web.A dynamic data-driven Web site. In questo modo è possibile creare un contesto di dati per il database e creare la classe che contiene il campo dati e personalizzare.This enables you to create a data context for the database and to create the class that contains the data field to customize. Per ulteriori informazioni, vedere Walkthrough: Creating a New Dynamic Data Web Site using Scaffolding.For more information, see Walkthrough: Creating a New Dynamic Data Web Site using Scaffolding.

Commenti

Quando una colonna in una tabella contiene una chiave esterna, i dati dinamici deduce che il valore di visualizzazione per la colonna dalla tabella cui viene fatto riferimento.When a column in a table contains a foreign key, Dynamic Data infers the display value for that column from the referenced table. Per impostazione predefinita, viene utilizzata la prima colonna della tabella di riferimento il cui tipo è string (o testo).By default, the first column of the referenced table whose type is string (or text) is used. Il DisplayColumnAttribute attributo consente di modificare questo comportamento predefinito e specificare una colonna della tabella padre diverso da utilizzare come colonna per il campo di chiave esterno.The DisplayColumnAttribute attribute enables you to change this default behavior and to specify a different parent table column to use as the column for the foreign key field.

Quando si applica questo attributo, è necessario rispettare le limitazioni d'utilizzo seguenti:When you apply this attribute, you must adhere to the following usage constraints:

  • L'attributo può essere applicato solo a una classe.The attribute can only be applied to a class.

  • L'attributo può essere ereditato dalle classi derivate.The attribute can be inherited by derived classes.

  • L'attributo può essere applicato solo una volta.The attribute can be applied only one time.

Costruttori

DisplayColumnAttribute(String) DisplayColumnAttribute(String) DisplayColumnAttribute(String) DisplayColumnAttribute(String)

Inizializza una nuova istanza della classe DisplayColumnAttribute utilizzando la colonna specificata.Initializes a new instance of the DisplayColumnAttribute class by using the specified column.

DisplayColumnAttribute(String, String) DisplayColumnAttribute(String, String) DisplayColumnAttribute(String, String) DisplayColumnAttribute(String, String)

Inizializza una nuova istanza della classe DisplayColumnAttribute utilizzando le colonne di visualizzazione e ordinamento specificate.Initializes a new instance of the DisplayColumnAttribute class by using the specified display and sort columns.

DisplayColumnAttribute(String, String, Boolean) DisplayColumnAttribute(String, String, Boolean) DisplayColumnAttribute(String, String, Boolean) DisplayColumnAttribute(String, String, Boolean)

Inizializza una nuova istanza della classe DisplayColumnAttribute utilizzando la colonna di visualizzazione, la colonna di ordinamento e l'ordinamento specificati.Initializes a new instance of the DisplayColumnAttribute class by using the specified display column, and the specified sort column and sort order.

Proprietà

DisplayColumn DisplayColumn DisplayColumn DisplayColumn

Ottiene il nome della colonna da utilizzare come campo di visualizzazione.Gets the name of the column to use as the display field.

SortColumn SortColumn SortColumn SortColumn

Ottiene il nome della colonna da utilizzare per l'ordinamento.Gets the name of the column to use for sorting.

SortDescending SortDescending SortDescending SortDescending

Ottiene un valore che indica se applicare un ordinamento crescente o decrescente.Gets a value that indicates whether to sort in descending or ascending order.

TypeId TypeId TypeId TypeId

Quando è implementata in una classe derivata, ottiene un identificatore univoco della classe Attribute.When implemented in a derived class, gets a unique identifier for this Attribute.

(Inherited from Attribute)

Metodi

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Restituisce un valore che indica se questa istanza è uguale a un oggetto specificato.Returns a value that indicates whether this instance is equal to a specified object.

(Inherited from Attribute)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Restituisce il codice hash per l'istanza.Returns the hash code for this instance.

(Inherited from Attribute)
GetType() GetType() GetType() GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Inherited from Object)
IsDefaultAttribute() IsDefaultAttribute() IsDefaultAttribute() IsDefaultAttribute()

In caso di override in una classe derivata, indica se il valore di questa istanza è il valore predefinito per la classe derivata.When overridden in a derived class, indicates whether the value of this instance is the default value for the derived class.

(Inherited from Attribute)
Match(Object) Match(Object) Match(Object) Match(Object)

Quando è sottoposto a override in una classe derivata, restituisce un valore che indica se questa istanza equivale a un oggetto specificato.When overridden in a derived class, returns a value that indicates whether this instance equals a specified object.

(Inherited from Attribute)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Inherited from Object)

Implementazioni dell'interfaccia esplicita

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Esegue il mapping di un set di nomi a un set corrispondente di ID dispatch.Maps a set of names to a corresponding set of dispatch identifiers.

(Inherited from Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _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.Retrieves the type information for an object, which can be used to get the type information for an interface.

(Inherited from Attribute)
_Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32)

Recupera il numero delle interfacce di informazioni sul tipo fornite da un oggetto (0 o 1).Retrieves the number of type information interfaces that an object provides (either 0 or 1).

(Inherited from Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Fornisce l'accesso a proprietà e metodi esposti da un oggetto.Provides access to properties and methods exposed by an object.

(Inherited from Attribute)

Si applica a