Поделиться через

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

  • Статья

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

Осторожность

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

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

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

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

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

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

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

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

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

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

См. также