DisplayColumnAttribute Класс

Определение

Задает столбец, в котором указанная в ссылке таблица отображается в виде столбца внешних ключей.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)]
[System.AttributeUsage]
public class DisplayColumnAttribute : Attribute
type DisplayColumnAttribute = class
    inherit Attribute
Public Class DisplayColumnAttribute
Inherits Attribute
Наследование
DisplayColumnAttribute
Атрибуты

Примеры

В следующем примере показано использование атрибута DisplayColumnAttribute.The following example shows how to use the DisplayColumnAttribute attribute. В этом примере выполняются следующие задачи.The example performs the following tasks:

  • Реализует разделяемые классы метаданных для таблиц Address и Customer, которые являются родительскими таблицами для таблицы CustomerAddress.Implements metadata partial classes for the Address and Customer tables, which are parent tables for the CustomerAddress table.

  • Применяет Addressатрибутк разделяемому классу метаданных, чтобы указать следующее: DisplayColumnAttributeApplies the DisplayColumnAttribute attribute to the Address metadata partial class to specify the following:

    • Столбец City из таблицы Address (родительская таблица) отображается как столбец внешнего ключа в дочерней таблице CustomerAddress.The City column from the Address table (the parent table) is displayed as the foreign-key column in the CustomerAddress child table.

    • Столбец PostalCode из таблицы Address (родительская таблица) используется для сортировки поля выбора адреса в дочерней таблице CustomerAddress.The PostalCode column from the Address table (the parent table) is used for sorting the Address selection box in the CustomerAddress child table.

    • Порядок сортировки устанавливается по возрастанию.The sort order is set to ascending.

В примере DisplayColumnAttribute атрибут применяется Customer к разделяемому классу метаданных, чтобы указать, что столбец LastName в качестве внешнего ключа для таблицы 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.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

Чтобы скомпилировать пример, вам потребуется следующее:To compile the example, you need the following:

  • Любой выпуск Visual Studio 2010 или более поздней версии.Any edition of Visual Studio 2010 or later.

  • Образец базы данных AdventureWorksLT.The AdventureWorksLT sample database. Сведения о том, как скачать и установить образец базы данных SQL Server, см . в разделе Microsoft SQL Server примеров продуктов: База данных на GitHub.For information about how to download and install the SQL Server sample database, see Microsoft SQL Server Product Samples: Database on GitHub. Убедитесь, что установлена правильная версия образца базы данных для используемой версии SQL Server.Make sure that you install the correct version of the sample database for the version of SQL Server that you are running.

  • Динамический управляемый данными веб-сайт.A dynamic data-driven Web site. Это позволяет создать контекст данных для базы данных и создать класс, содержащий настраиваемое поле данных.This enables you to create a data context for the database and to create the class that contains the data field to customize. Для получения дополнительной информации см. Walkthrough: Creating a New Dynamic Data Web Site using Scaffolding.For more information, see Walkthrough: Creating a New Dynamic Data Web Site using Scaffolding.

Комментарии

Если столбец в таблице содержит внешний ключ, платформа динамических данных выводит отображаемое значение для этого столбца из упоминаемой таблицы.When a column in a table contains a foreign key, Dynamic Data infers the display value for that column from the referenced table. По умолчанию используется первый столбец ссылочной таблицы, тип которого — String (или Text).By default, the first column of the referenced table whose type is string (or text) is used. DisplayColumnAttribute Атрибут позволяет изменить это поведение по умолчанию и указать другой столбец родительской таблицы для использования в качестве столбца для поля внешнего ключа.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.

При применении этого атрибута необходимо соблюдать следующие ограничения использования.When you apply this attribute, you must adhere to the following usage constraints:

  • Атрибут может применяться только к классу.The attribute can only be applied to a class.

  • Атрибут может наследоваться производными классами.The attribute can be inherited by derived classes.

  • Атрибут может применяться только один раз.The attribute can be applied only one time.

Конструкторы

DisplayColumnAttribute(String)

Инициализирует новый экземпляр DisplayColumnAttribute, используя заданный столбец.Initializes a new instance of the DisplayColumnAttribute class by using the specified column.

DisplayColumnAttribute(String, String)

Инициализирует новый экземпляр DisplayColumnAttribute, используя заданный отображаемый столбец и столбец сортировки.Initializes a new instance of the DisplayColumnAttribute class by using the specified display and sort columns.

DisplayColumnAttribute(String, String, Boolean)

Инициализирует новый экземпляр DisplayColumnAttribute, используя указанный отображаемый столбец, а также заданный столбец для сортировки и порядок сортировки.Initializes a new instance of the DisplayColumnAttribute class by using the specified display column, and the specified sort column and sort order.

Свойства

DisplayColumn

Получает имя столбца, который следует использовать в качестве отображаемого поля.Gets the name of the column to use as the display field.

SortColumn

Получает имя столбца, который следует использовать для сортировки.Gets the name of the column to use for sorting.

SortDescending

Получает значение, указывающее, в каком порядке выполняется сортировка: в порядке возрастания или в порядке убывания.Gets a value that indicates whether to sort in descending or ascending order.

TypeId

При реализации в производном классе возвращает уникальный идентификатор для этого Attribute.When implemented in a derived class, gets a unique identifier for this Attribute.

(Унаследовано от Attribute)

Методы

Equals(Object)

Возвращает значение, показывающее, равен ли экземпляр указанному объекту.Returns a value that indicates whether this instance is equal to a specified object.

(Унаследовано от Attribute)
GetHashCode()

Возвращает хэш-код данного экземпляра.Returns the hash code for this instance.

(Унаследовано от Attribute)
GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
IsDefaultAttribute()

При переопределении в производном классе указывает, является ли значение этого экземпляра значением по умолчанию для производного класса.When overridden in a derived class, indicates whether the value of this instance is the default value for the derived class.

(Унаследовано от Attribute)
Match(Object)

При переопределении в производном классе возвращает значение, указывающее, является ли этот экземпляр равным заданному объекту.When overridden in a derived class, returns a value that indicates whether this instance equals a specified object.

(Унаследовано от Attribute)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Унаследовано от Object)

Явные реализации интерфейса

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

Сопоставляет набор имен соответствующему набору идентификаторов диспетчеризации.Maps a set of names to a corresponding set of dispatch identifiers.

(Унаследовано от Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Возвращает сведения о типе объекта, которые можно использовать для получения сведений о типе интерфейса.Retrieves the type information for an object, which can be used to get the type information for an interface.

(Унаследовано от Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Возвращает количество предоставляемых объектом интерфейсов для доступа к сведениям о типе (0 или 1).Retrieves the number of type information interfaces that an object provides (either 0 or 1).

(Унаследовано от Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Предоставляет доступ к открытым свойствам и методам объекта.Provides access to properties and methods exposed by an object.

(Унаследовано от Attribute)

Применяется к