DisplayColumnAttribute Klasse

Definition

Namespace:

System.ComponentModel.DataAnnotations

Assembly:

System.ComponentModel.DataAnnotations.dll

Gibt die Spalte an, die in der bezeichneten 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

Das folgende Beispiel zeigt, wie das DisplayColumnAttribute Attribut verwendet wird. Im Beispiel werden die folgenden Aufgaben ausgeführt:

• Implementiert Metadatenteilklassen für die Tabellen "Adresse" und "Kunden", die übergeordnete Tabellen für die Tabelle "CustomerAddress" sind.

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

  • Die Spalte "Ort" aus der Tabelle "Adresse" (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 Adressauswahlfelds in der untergeordneten Tabelle "CustomerAddress" verwendet.

  • Die Sortierreihenfolge wird aufsteigend festgelegt.

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.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

Zum Kompilieren des Beispiels benötigen Sie Folgendes:

• Jede Ausgabe 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 Product Samples: Database on 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. Auf diese Weise können Sie einen Datenkontext für die Datenbank erstellen und die Klasse erstellen, die das zu anpassende 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 referenzierten Tabelle ab. Standardmäßig wird die erste Spalte der referenzierten Tabelle verwendet, 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 Verwendungseinschrä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

Name	Beschreibung
DisplayColumnAttribute(String, String, Boolean)	Initialisiert eine neue Instanz der Klasse mithilfe der DisplayColumnAttribute angegebenen Anzeigespalte und der angegebenen Sortierspalte und sortierreihenfolge.
DisplayColumnAttribute(String, String)	Initialisiert eine neue Instanz der Klasse mithilfe der DisplayColumnAttribute angegebenen Anzeige- und Sortierspalten.
DisplayColumnAttribute(String)	Initialisiert eine neue Instanz der Klasse mithilfe der DisplayColumnAttribute angegebenen Spalte.

Eigenschaften

Name	Beschreibung
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 in absteigender oder aufsteigender Reihenfolge sortiert werden soll.
TypeId	Wenn sie in einer abgeleiteten Klasse implementiert wird, wird ein eindeutiger Bezeichner für diese Attribute. (Geerbt von Attribute)

Methoden

Name	Beschreibung
Equals(Object)	Gibt einen Wert zurück, der angibt, ob diese Instanz einem angegebenen Objekt entspricht. (Geerbt von Attribute)
GetHashCode()	Gibt den Hashcode für diesen instance zurück. (Geerbt von Attribute)
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
IsDefaultAttribute()	Wenn sie in einer abgeleiteten Klasse überschrieben wird, gibt an, ob der Wert dieser Instanz der Standardwert für die abgeleitete Klasse ist. (Geerbt von Attribute)
Match(Object)	Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird ein Wert zurückgegeben, der angibt, ob diese Instanz einem angegebenen Objekt entspricht. (Geerbt von Attribute)
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Explizite Schnittstellenimplementierungen

Name	Beschreibung
_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Ordnet eine Reihe von Namen einer entsprechenden Reihe von Dispatchbezeichnern zu. (Geerbt von Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Ruft die Typinformationen für ein Objekt ab, mit denen die Typinformationen für eine Schnittstelle abgerufen werden können. (Geerbt von Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Ruft die Anzahl der Schnittstellen mit Typinformationen ab, die von einem Objekt bereitgestellt werden (0 oder 1). (Geerbt von Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Bietet Zugriff auf Eigenschaften und Methoden, die von einem Objekt verfügbar gemacht werden. (Geerbt von Attribute)