DisplayColumnAttribute Klasse

Definition

Namespace:

System.ComponentModel.DataAnnotations

Assembly:

System.ComponentModel.Annotations.dll

Quelle:

DisplayColumnAttribute.cs

Gibt die Spalte an, die in der angegebenen Tabelle als Fremdschlüsselspalte angezeigt wird.

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

Vererbung

Object

Attribute

DisplayColumnAttribute

Attribute

AttributeUsageAttribute

Beispiele

Im folgenden Beispiel wird die Verwendung des DisplayColumnAttribute-Attributs veranschaulicht. Im Beispiel werden die folgenden Aufgaben ausgeführt:

• Implementiert partielle Metadatenklassen für die Tabellen Address und Customer, bei denen es sich um übergeordnete Tabellen für die Tabelle CustomerAddress handelt.

• Wendet das DisplayColumnAttribute Attribut auf die Address partielle Metadatenklasse an, um Folgendes anzugeben:

  • Die Spalte City aus der Tabelle Address (die übergeordnete Tabelle) wird als Fremdschlüsselspalte in der untergeordneten Tabelle CustomerAddress angezeigt.

  • Die Spalte Postleitzahl aus der Tabelle Adresse (die übergeordnete Tabelle) wird zum Sortieren des Auswahlfelds Adresse in der untergeordneten Tabelle CustomerAddress verwendet.

  • Die Sortierreihenfolge ist auf aufsteigend festgelegt.

Im Beispiel wird das DisplayColumnAttribute Attribut auf die Customer partielle Metadatenklasse angewendet, um anzugeben, dass die LastName-Spalte in als Fremdschlüsselspalte für die CustomerAddress-Tabelle angezeigt wird.

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

Um das Beispiel zu kompilieren, benötigen Sie Folgendes:

• Jede Edition von Visual Studio 2010 oder höher.

• Die AdventureWorksLT-Beispieldatenbank. Informationen zum Herunterladen und Installieren der SQL Server Beispieldatenbank finden Sie unter Microsoft SQL Server-Produktbeispiele: Datenbank auf GitHub. Stellen Sie sicher, dass Sie die richtige Version der Beispieldatenbank für die Version von SQL Server installieren, die Sie ausführen.

• Eine dynamische datengesteuerte Website. Dadurch können Sie einen Datenkontext für die Datenbank erstellen und die Klasse erstellen, die das anzupassende Datenfeld enthält. Weitere Informationen finden Sie unter Walkthrough: Creating a New Dynamic Data Web Site using Scaffolding.

Hinweise

Wenn eine Spalte in einer Tabelle einen Fremdschlüssel enthält, leitet Dynamic Data den Anzeigewert für diese Spalte aus der Tabelle ab, auf die verwiesen wird. Standardmäßig wird die erste Spalte der Tabelle verwendet, auf die verwiesen wird, deren Typ Zeichenfolge (oder Text) ist. Mit DisplayColumnAttribute dem -Attribut können Sie dieses Standardverhalten ändern und eine andere übergeordnete Tabellenspalte angeben, die als Spalte für das Fremdschlüsselfeld verwendet werden soll.

Wenn Sie dieses Attribut anwenden, müssen Sie die folgenden Nutzungseinschränkungen einhalten:

• Das Attribut kann nur auf eine Klasse angewendet werden.

• Das Attribut kann von abgeleiteten Klassen geerbt werden.

• Das Attribut kann nur einmal angewendet werden.

Konstruktoren

DisplayColumnAttribute(String)	Initialisiert eine neue Instanz der DisplayColumnAttribute-Klasse unter Verwendung der angegebenen Spalte.
DisplayColumnAttribute(String, String)	Initialisiert eine neue Instanz der DisplayColumnAttribute-Klasse unter Verwendung der angegebenen Anzeige- und Sortierspalten.
DisplayColumnAttribute(String, String, Boolean)	Initialisiert eine neue Instanz der DisplayColumnAttribute-Klasse mithilfe der angegebenen Anzeigespalte und der angegebenen Sortierspalte und Sortierreihenfolge.

Eigenschaften

DisplayColumn	Ruft den Namen der Spalte ab, die als Anzeigefeld verwendet werden soll.
SortColumn	Ruft den Namen der Spalte ab, die für die Sortierung verwendet werden soll.
SortDescending	Ruft einen Wert ab, der angibt, ob die Sortierung in aufsteigender oder absteigender Reihenfolge erfolgen soll.
TypeId	Ruft bei Implementierung in einer abgeleiteten Klasse einen eindeutigen Bezeichner für dieses Attribute ab. (Geerbt von Attribute)

Methoden

Equals(Object)	Gibt einen Wert zurück, der angibt, ob diese Instanz gleich einem angegebenen Objekt ist. (Geerbt von Attribute)
GetHashCode()	Gibt den Hashcode für diese Instanz zurück. (Geerbt von Attribute)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
IsDefaultAttribute()	Gibt beim Überschreiben in einer abgeleiteten Klasse an, ob der Wert der Instanz der Standardwert für die abgeleitete Klasse ist. (Geerbt von Attribute)
Match(Object)	Beim Überschreiben in einer abgeleiteten Klasse wird ein Wert zurückgegeben, der angibt, ob diese Instanz einem bestimmten Objekt entspricht. (Geerbt von Attribute)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)