Atributos en controles de formularios Windows Forms

  • Artículo

.NET Framework proporciona una variedad de atributos que puede aplicar a los miembros de sus controles y componentes personalizados. Algunos de estos atributos afectan al comportamiento en tiempo de ejecución de una clase y otros afectan al comportamiento en tiempo de diseño.

Precaución

Este contenido se escribió para .NET Framework. Si usa .NET 6 o una versión posterior, use este contenido con precaución. El sistema de diseñador ha cambiado para Windows Forms y es importante que revise el artículo Cambios del diseñador desde .NET Framework.

Atributos para las propiedades de controles y componentes

En la tabla siguiente se muestran los atributos que se pueden aplicar a las propiedades o a otros miembros de los controles y componentes personalizados. Para obtener un ejemplo que utiliza muchos de estos atributos, vea Cómo: Aplicar atributos en controles de Windows Forms.

Atributo Descripción
AmbientValueAttribute Especifica el valor para pasar a una propiedad que hace que esta obtenga su valor de otro origen. Esto se conoce como ambiente.
BrowsableAttribute Especifica si una propiedad o un evento se debería mostrar en una ventana Propiedades.
CategoryAttribute Especifica el nombre de la categoría en la que se agrupa la propiedad o el evento cuando se muestra en un control PropertyGrid establecido en el modo Categorized.
DefaultValueAttribute Especifica el valor predeterminado de una propiedad.
DescriptionAttribute Especifica una descripción para una propiedad o evento.
DisplayNameAttribute Especifica el nombre para mostrar de una propiedad, evento o método public void que no toma ningún argumento.
EditorAttribute Especifica el editor que se va a utilizar para cambiar una propiedad.
EditorBrowsableAttribute Especifica que una propiedad o un método son visibles en un editor.
HelpKeywordAttribute Especifica la palabra clave de contexto para una clase o miembro.
LocalizableAttribute Especifica si se debería localizar una propiedad.
PasswordPropertyTextAttribute Indica los caracteres que ocultan la representación del texto de un objeto, como asteriscos.
ReadOnlyAttribute Especifica si la propiedad a la que se enlaza este atributo es de solo lectura o de lectura y escritura en tiempo de diseño.
RefreshPropertiesAttribute Indica que la cuadrícula de la propiedad debería actualizarse cuando cambia el valor de propiedad asociado.
TypeConverterAttribute Especifica el tipo que se debe utilizar como convertidor para el objeto al que está enlazado este atributo.

Atributos para las propiedades de enlaces de datos

En la tabla siguiente se muestran los atributos que se pueden aplicar para especificar cómo los controles y componentes personalizados interactúan con enlace de datos.

Atributo Descripción
BindableAttribute Especifica si una propiedad se utiliza normalmente para enlace.
ComplexBindingPropertiesAttribute Especifica las propiedades del origen de datos y del miembro de datos para un componente.
DefaultBindingPropertyAttribute Especifica la propiedad de enlace predeterminada para un componente.
LookupBindingPropertiesAttribute Especifica las propiedades del origen de datos y del miembro de datos para un componente.
AttributeProviderAttribute Habilita la redirección del atributo.

Atributos para las clases

En la tabla siguiente se muestran los atributos que se pueden aplicar para especificar en tiempo de diseño el comportamiento de los controles y componentes personalizados.

Atributo Descripción
DefaultEventAttribute Especifica el evento predeterminado para un componente.
DefaultPropertyAttribute Especifica la propiedad predeterminada para un componente.
DesignerAttribute Especifica la clase utilizada para implementar, en tiempo de diseño, los servicios para un componente.
DesignerCategoryAttribute Especifica que el diseñador de una clase pertenece a una categoría determinada.
ToolboxItemAttribute Representa un atributo de un elemento del cuadro de herramientas.
ToolboxItemFilterAttribute Especifica la cadena del filtro y el tipo de filtro que se va a utilizar para un elemento del cuadro de herramientas.

Consulte también