DisplayColumnAttribute Klasse

Definition

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

Eigenschaften

Methoden

Explizite Schnittstellenimplementierungen

Gilt für: