Compartilhar via

Atributos em controles do Windows Forms

  • Artigo

O .NET Framework fornece uma variedade de atributos que você pode aplicar aos membros de seus controles e componentes personalizados. Alguns desses atributos afetam o comportamento em tempo de execução de uma classe e outros afetam o comportamento de tempo de design.

Cuidado

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

Atributos para propriedades de controle e componente

A tabela a seguir mostra os atributos que você pode aplicar às propriedades ou a outros membros de seus controles e componentes personalizados. Para obter um exemplo que usa muitos desses atributos, consulte Como: Aplicar Atributos em Controles do Windows Forms.

Atributo Descrição
AmbientValueAttribute Especifica o valor a ser passado para uma propriedade para fazer com que a propriedade obtenha seu valor de outra fonte. 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 a propriedade ou evento deve ser agrupado quando exibido em um controle PropertyGrid ajustado para o modo Categorized.
DefaultValueAttribute Especifica o valor padrão de uma propriedade.
DescriptionAttribute Especifica uma descrição para uma propriedade ou evento.
DisplayNameAttribute Especifica o nome de exibição de um método de propriedade, evento ou public void que não usa argumentos.
EditorAttribute Especifica o editor a ser usado para alterar uma propriedade.
EditorBrowsableAttribute Especifica que uma propriedade ou método pode ser exibido 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 este atributo está associado é somente leitura ou leitura/gravação em tempo de projeto.
RefreshPropertiesAttribute Indica que a grade de propriedades deve ser atualizada quando o valor da propriedade associada for alterado.
TypeConverterAttribute Especifica a qual tipo usar como conversor para o objeto ao qual esse atributo está associado.

Atributos para propriedades de associação de dados

A tabela a seguir mostra os atributos que você pode aplicar para especificar como seus controles e componentes personalizados interagem com a associação de dados.

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

Atributos para classes

A tabela a seguir mostra os atributos que você pode aplicar para especificar o comportamento de seus controles e componentes personalizados em tempo de design.

Atributo Descrição
DefaultEventAttribute Especifica o evento padrão para um componente.
DefaultPropertyAttribute Especifica a propriedade padrão para um componente.
DesignerAttribute Especifica a classe usada para implementar serviços de design-time 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 a ser usado para um item da Caixa de Ferramentas.

Consulte também