Атрибуты в элементах управления Windows Forms

  • Статья

.NET Framework предоставляет широкий набор атрибутов, которые можно применять к членам пользовательских элементов управления и компонентов. Некоторые из этих атрибутов влияют на поведение класса во время выполнения, а другие – на поведение во время разработки.

Внимание

Это содержимое было написано для платформа .NET Framework. Если вы используете .NET 6 или более позднюю версию, используйте это содержимое с осторожностью. Система конструктора изменилась для Windows Forms, и важно ознакомиться с изменениями конструктора после платформа .NET Framework статьи.

Атрибуты для свойств элементов управления и компонентов

В следующей таблице представлены атрибуты, которые можно применять к свойствам или другим членам пользовательских элементов управления и компонентов. Пример использования этих атрибутов см. в разделе Практическое руководство. Применение атрибутов в элементах управления Windows Forms.

Атрибут Description
AmbientValueAttribute Указывает значение, которое нужно передать в свойство, чтобы свойство получило свое значение из другого источника. Это называется окружением.
BrowsableAttribute Указывает, должно ли отображаться свойство в окне Свойства.
CategoryAttribute Задает имя категории, в которой при отображении в элементе управления PropertyGrid для группировки свойств или событий установлен режим Categorized.
DefaultValueAttribute Указывает значение свойства по умолчанию.
DescriptionAttribute Задает описание для свойства или события.
DisplayNameAttribute Указывает отображаемое имя для свойства, события или метода public void, у которого нет аргументов.
EditorAttribute Указывает редактор, используемый для изменения свойства.
EditorBrowsableAttribute Указывает, что свойство или метод можно просматривать в редакторе.
HelpKeywordAttribute Указывает ключевое слово контекста для класса или элемента.
LocalizableAttribute Указывает, должно ли быть локализовано свойство.
PasswordPropertyTextAttribute Указывает, что текстовое представление объекта скрыто символами, например звездочками.
ReadOnlyAttribute Указывает, предназначено ли свойство, к которому привязан этот атрибут, только для чтения или для чтения и записи во время разработки.
RefreshPropertiesAttribute Указывает, что таблица свойств должна обновляться при изменении значения связанного свойства.
TypeConverterAttribute Указывает, какой тип использовать в качестве преобразователя для объекта, с которым связан этот атрибут.

Атрибуты для свойств привязки данных

В следующей таблице представлены атрибуты, с помощью которых можно указывать, как пользовательские элементы управления и компоненты взаимодействуют с привязкой данных.

Атрибут Description
BindableAttribute Указывает, используется ли обычно свойство для привязки.
ComplexBindingPropertiesAttribute Указывает источник данных и свойства элемента данных для компонента.
DefaultBindingPropertyAttribute Задает свойство привязки по умолчанию для компонента.
LookupBindingPropertiesAttribute Указывает источник данных и свойства элемента данных для компонента.
AttributeProviderAttribute Включает перенаправление атрибутов.

Атрибуты для классов

В следующей таблице представлены атрибуты, с помощью которых можно указать поведение пользовательских элементов управления и компонентов во время разработки.

Атрибут Description
DefaultEventAttribute Задает событие по умолчанию для компонента.
DefaultPropertyAttribute Задает свойство по умолчанию для компонента.
DesignerAttribute Указывает класс, используемый для реализации служб времени разработки для компонента.
DesignerCategoryAttribute Указывает, что конструктор для класса относится к определенной категории.
ToolboxItemAttribute Представляет атрибут элемента панели инструментов.
ToolboxItemFilterAttribute Задает строку фильтра и тип фильтра для элемента панели инструментов.

См. также