Partilhar via

Atributos em controles do Windows Forms

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 em tempo de design.

Atenção

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 Windows Forms e é importante que você revise as alterações do Designer desde o artigo do .NET Framework.

Atributos para propriedades de controle e componente

A tabela a seguir mostra os atributos que você pode aplicar a propriedades ou 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. Isto é conhecido como ambiente .
BrowsableAttribute Especifica se uma propriedade ou evento deve ser exibido numa janela Propriedades.
CategoryAttribute Especifica o nome da categoria na qual a propriedade ou evento deve ser agrupada quando é apresentada num controlo PropertyGrid configurado para o modo Categorized.
DefaultValueAttribute Especifica o valor padrão para uma propriedade.
DescriptionAttribute Especifica uma descrição para uma propriedade ou evento.
DisplayNameAttribute Especifica o nome para exibição de uma propriedade, evento ou public void método 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 visualizado 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á vinculado é somente leitura ou leitura/gravação em tempo de design.
RefreshPropertiesAttribute Indica que a grade de propriedades deve ser atualizada quando o valor da propriedade associada for alterado.
TypeConverterAttribute Especifica o tipo a ser usado como conversor para o objeto ao qual esse atributo está vinculado.

Atributos para propriedades de vinculaçã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 vinculação de dados.

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

Atributos de 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 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 da caixa de ferramentas.
ToolboxItemFilterAttribute Especifica a cadeia de caracteres de filtro e o tipo de filtro a serem usados para um item da Caixa de Ferramentas.

Ver também

  • Last updated on