Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Clase CategoryAttribute

 

Especifica el nombre de la categoría en la que se va a agrupar la propiedad o evento cuando se muestra en un PropertyGrid control establecido en el modo por categorías.

Espacio de nombres:   System.ComponentModel
Ensamblado:  System (en System.dll)

System.Object
  System.Attribute
    System.ComponentModel.CategoryAttribute

[AttributeUsageAttribute(AttributeTargets.All)]
public class CategoryAttribute : Attribute

NombreDescripción
System_CAPS_pubmethodCategoryAttribute()

Inicializa una nueva instancia de la CategoryAttribute nombre de clase de la categoría predeterminada.

System_CAPS_pubmethodCategoryAttribute(String)

Inicializa una nueva instancia de la CategoryAttribute clase utilizando el nombre de la categoría especificada.

NombreDescripción
System_CAPS_pubpropertySystem_CAPS_staticAction

Obtiene un CategoryAttribute que representa la categoría de acción.

System_CAPS_pubpropertySystem_CAPS_staticAppearance

Obtiene un CategoryAttribute que representa la categoría de apariencia.

System_CAPS_pubpropertySystem_CAPS_staticAsynchronous

Obtiene un CategoryAttribute que representa la categoría Asynchronous.

System_CAPS_pubpropertySystem_CAPS_staticBehavior

Obtiene un CategoryAttribute que representa la categoría de comportamiento.

System_CAPS_pubpropertyCategory

Obtiene el nombre de la categoría de la propiedad o evento que se aplica este atributo.

System_CAPS_pubpropertySystem_CAPS_staticData

Obtiene un CategoryAttribute que representa la categoría de datos.

System_CAPS_pubpropertySystem_CAPS_staticDefault

Obtiene un CategoryAttribute que representa la categoría predeterminada.

System_CAPS_pubpropertySystem_CAPS_staticDesign

Obtiene un CategoryAttribute que representa la categoría de diseño.

System_CAPS_pubpropertySystem_CAPS_staticDragDrop

Obtiene un CategoryAttribute que representa la categoría DragDrop.

System_CAPS_pubpropertySystem_CAPS_staticFocus

Obtiene un CategoryAttribute que representa la categoría de foco.

System_CAPS_pubpropertySystem_CAPS_staticFormat

Obtiene un CategoryAttribute que representa la categoría de formato.

System_CAPS_pubpropertySystem_CAPS_staticKey

Obtiene un CategoryAttribute que representa la categoría Key.

System_CAPS_pubpropertySystem_CAPS_staticLayout

Obtiene un CategoryAttribute que representa la categoría de diseño.

System_CAPS_pubpropertySystem_CAPS_staticMouse

Obtiene un CategoryAttribute que representa la categoría de Mouse.

System_CAPS_pubpropertyTypeId

Cuando se implementa en una clase derivada, obtiene un identificador único para este Attribute.(Heredado de Attribute).

System_CAPS_pubpropertySystem_CAPS_staticWindowStyle

Obtiene un CategoryAttribute que representa la categoría WindowStyle.

NombreDescripción
System_CAPS_pubmethodEquals(Object)

Devuelve si el valor del objeto especificado es igual a la actual CategoryAttribute...(Invalida Attribute.Equals(Object)).

System_CAPS_protmethodFinalize()

Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por el recolector de basura. (Heredado de Object).

System_CAPS_pubmethodGetHashCode()

Devuelve el código hash de este atributo.(Invalida Attribute.GetHashCode()).

System_CAPS_protmethodGetLocalizedString(String)

Busca el nombre traducido de la categoría especificada.

System_CAPS_pubmethodGetType()

Obtiene el Type de la instancia actual.(Heredado de Object).

System_CAPS_pubmethodIsDefaultAttribute()

Determina si este atributo es el valor predeterminado.(Invalida Attribute.IsDefaultAttribute()).

System_CAPS_pubmethodMatch(Object)

Cuando se invalida en una clase derivada, devuelve un valor que indica si esta instancia es igual al objeto especificado. (Heredado de Attribute).

System_CAPS_protmethodMemberwiseClone()

Crea una copia superficial del Object actual.(Heredado de Object).

System_CAPS_pubmethodToString()

Retorna una cadena que representa al objeto actual. (Heredado de Object).

NombreDescripción
System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Asigna un conjunto de nombres a un conjunto correspondiente de identificadores de envío.(Heredado de Attribute).

System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Obtiene la información del tipo de un objeto, que puede utilizarse para obtener la información del tipo de una interfaz. (Heredado de Attribute).

System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.GetTypeInfoCount(UInt32)

Recupera el número de interfaces de tipo de información que suministra un objeto (0 ó 1)

(Heredado de Attribute).

System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Proporciona acceso a las propiedades y los métodos expuestos por un objeto.(Heredado de Attribute).

Un CategoryAttribute indica la categoría para asociar la propiedad asociada o el evento cuando se enumeran las propiedades o eventos en un PropertyGrid control establecida en Categorized modo. Si un CategoryAttribute no se ha aplicado a una propiedad o evento, el PropertyGrid lo asocia con el varios categoría. Puede crearse una nueva categoría para cualquier nombre especificando el nombre de la categoría en el constructor para la CategoryAttribute.

El Category propiedad indica el nombre de la categoría que representa el atributo. El Category propiedad también proporciona una localización transparente de nombres de categoría.

Notas para desarrolladores de herederos:

Si utiliza nombres de categoría diferentes a los nombres predefinidos y desea adaptar los nombres de categoría, debe invalidar el GetLocalizedString método.

La CategoryAttribute clase define las siguientes categorías comunes:

Categoría

Descripción

Action

Propiedades relacionadas con las acciones disponibles.

Appearance

Propiedades relacionadas con la apariencia de una entidad.

Behavior

Propiedades relacionadas con la forma en que actúa una entidad.

Data

Propiedades relacionadas con datos y administración del origen de datos.

Default

Propiedades que se agrupan en una categoría predeterminada.

Design

Propiedades que están disponibles sólo en tiempo de diseño.

DragDrop

Propiedades relacionadas con las operaciones de arrastrar y colocar.

Focus

Propiedades relacionadas con el foco.

Format

Propiedades relacionadas con el formato.

Key

Propiedades relacionadas con el teclado.

Layout

Propiedades relacionadas con el diseño.

Mouse

Propiedades relacionadas con el mouse.

WindowStyle

Propiedades relacionadas con el estilo de ventana de los formularios de nivel superior.

Para obtener más información, consulta Extender metadatos mediante atributos.

En el ejemplo siguiente se crea el MyImage propiedad. La propiedad tiene dos atributos: un DescriptionAttribute y un CategoryAttribute.

[Description("The image associated with the control"),Category("Appearance")] 
 public Image MyImage {
    get {
       // Insert code here.
       return image1;
    }
    set {
       // Insert code here.
    }
 }

En el ejemplo siguiente se obtiene la categoría de MyImage. En primer lugar, el código obtiene una PropertyDescriptorCollection con todas las propiedades del objeto. A continuación, el código utiliza un índice en la PropertyDescriptorCollection para obtener MyImage. A continuación, devuelve los atributos de esta propiedad y los guarda en la variable attributes.

A continuación, imprime la categoría recuperando CategoryAttribute desde el AttributeCollection, y escribir en la pantalla de la consola.

// Gets the attributes for the property.
 AttributeCollection attributes = 
    TypeDescriptor.GetProperties(this)["MyImage"].Attributes;

 // Prints the description by retrieving the CategoryAttribute.
 // from the AttributeCollection.
 CategoryAttribute myAttribute = 
    (CategoryAttribute)attributes[typeof(CategoryAttribute)];
 Console.WriteLine(myAttribute.Category);

.NET Framework
Disponible desde 1.1
Silverlight
Disponible desde 2.0
Windows Phone Silverlight
Disponible desde 7.0

Cualquier miembro ( Compartido en Visual Basic) estático público de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Volver al principio
Mostrar: