Atributos em controles dos Windows Forms

  • Artigo

O .NET Framework fornece uma variedade de atributos que podem se aplicados aos membros de seus controles personalizados e componentes. Alguns desses atributos afetam o comportamento de uma classe no tempo de execução, enquanto outros afetam o comportamento no tempo de design.

Cuidado

Este conteúdo foi escrito para .NET Framework. Se você estiver usando o .NET 6 ou uma versão posterior, use este conteúdo com cuidado. O sistema de designer foi alterado para o Windows Forms e é importante que você revise as alterações do Designer desde o artigo do .NET Framework .

Atributos de propriedades de controles e componentes

A tabela a seguir mostra os atributos que podem ser aplicados a propriedades ou outros membros de seus controles e componentes personalizados. Para ver um exemplo que usa muitos desses atributos, consulte Como aplicar atributos a controles dos Windows Forms.

Atributo Descrição
AmbientValueAttribute Especifica o valor a ser passado para uma propriedade para fazer com que a propriedade obtenha o seu valor de outra origem. Isso é conhecido como ambiente.
BrowsableAttribute Especifica se uma propriedade ou evento deve ser exibido em uma janela Propriedades.
CategoryAttribute Especifica o nome da categoria na qual agrupar a propriedade ou evento quando exibido em um PropertyGrid controle definido como Categorized modo.
DefaultValueAttribute Especifica o valor padrão de uma propriedade.
DescriptionAttribute Especifica uma descrição de uma propriedade ou evento.
DisplayNameAttribute Especifica o nome de exibição de uma propriedade, evento ou método public void que não usa argumentos.
EditorAttribute Especifica o editor que deve ser usado para alterar uma propriedade.
EditorBrowsableAttribute Especifica que uma propriedade ou método é visível em um editor.
HelpKeywordAttribute Especifica a palavra-chave de contexto para uma classe ou membro.
LocalizableAttribute Especifica se uma propriedade deve ser localizada.
PasswordPropertyTextAttribute Indica que a representação de texto de um objeto é obscurecida por caracteres como asteriscos.
ReadOnlyAttribute Especifica se a propriedade à qual esse atributo está associado é somente leitura ou leitura/gravação no tempo de design.
RefreshPropertiesAttribute Indica que a grade de propriedades deve ser atualizada quando o valor da propriedade associada é alterado.
TypeConverterAttribute Especifica o tipo a ser usado como um conversor para o objeto ao qual este atributo está associado.

Atributos para propriedades de vinculação de dados

A tabela a seguir mostra os atributos que podem ser aplicados para especificar como os controles e componentes personalizados interagem com vinculação de dados.

Atributo Descrição
BindableAttribute Especifica se uma propriedade normalmente é usada para associação.
ComplexBindingPropertiesAttribute Especifica a fonte de dados e as propriedades de membro de dados para um componente.
DefaultBindingPropertyAttribute Especifica a propriedade de associação padrão de um componente.
LookupBindingPropertiesAttribute Especifica a fonte de dados e as propriedades de membro de dados para um componente.
AttributeProviderAttribute Habilita o redirecionamento de atributo.

Atributos para classes

A tabela a seguir mostra os atributos que podem ser aplicados para especificar o comportamento dos seus controles e componentes personalizados no tempo de design.

Atributo Descrição
DefaultEventAttribute Especifica o evento padrão de um componente.
DefaultPropertyAttribute Especifica a propriedade padrão de um componente.
DesignerAttribute Especifica a classe usada para implementar os serviços de tempo de design para um componente.
DesignerCategoryAttribute Especifica que o designer de uma classe pertence a uma determinada categoria.
ToolboxItemAttribute Representa um atributo de um item de caixa de ferramentas.
ToolboxItemFilterAttribute Especifica a cadeia de caracteres de filtro e o tipo de filtro para um item de Caixa de ferramentas.

Confira também