DisplayColumnAttribute DisplayColumnAttribute DisplayColumnAttribute DisplayColumnAttribute Class

Определение

Задает столбец, в котором указанная в ссылке таблица отображается в виде столбца внешних ключей.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
Наследование
DisplayColumnAttributeDisplayColumnAttributeDisplayColumnAttributeDisplayColumnAttribute
Атрибуты

Примеры

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

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

  • Применяет DisplayColumnAttribute атрибут Address разделяемый класс метаданных, указав следующее:Applies 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 разделяемый класс метаданных, чтобы указать, что в столбце «Фамилия» отображается как столбец внешнего ключа для таблицы 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

Чтобы скомпилировать этот пример, вам потребуется следующее: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 Product Samples: База данных на сайте 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. По умолчанию используется первый столбец из связанной таблицы, тип которого является строка (или текста).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(String) DisplayColumnAttribute(String) DisplayColumnAttribute(String)

Инициализирует новый экземпляр DisplayColumnAttribute, используя заданный столбец.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)

Инициализирует новый экземпляр DisplayColumnAttribute, используя заданный отображаемый столбец и столбец сортировки.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)

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

Свойства

DisplayColumn DisplayColumn DisplayColumn DisplayColumn

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

SortColumn SortColumn SortColumn SortColumn

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

SortDescending SortDescending SortDescending SortDescending

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

TypeId TypeId TypeId TypeId

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

(Inherited from Attribute)

Методы

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

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

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

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

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

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

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

При переопределении в производном классе показывает, является ли значение данного экземпляра значением по умолчанию для производного класса.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)

При переопределении в производном классе возвращает значение, указывающее, является ли этот экземпляр равным заданному объекту.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()

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

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

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

(Inherited from Object)

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

_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)

Сопоставляет набор имен соответствующему набору идентификаторов диспетчеризации.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)

Возвращает сведения о типе объекта, которые могут использоваться для получения сведений о типе интерфейса.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)

Возвращает количество предоставляемых объектом интерфейсов для доступа к сведениям о типе (0 или 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)

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

(Inherited from Attribute)

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