CategoryAttribute Clase

Definición

public ref class CategoryAttribute : Attribute

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

public class CategoryAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.All)>]
type CategoryAttribute = class
    inherit Attribute

type CategoryAttribute = class
    inherit Attribute

Public Class CategoryAttribute
Inherits Attribute

Herencia

Object

Attribute

CategoryAttribute

Atributos

AttributeUsageAttribute

Ejemplos

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

   [Description("The image associated with the control"),Category("Appearance")]
   System::Drawing::Image^ get()
   {
      // Insert code here.
      return m_Image1;
   }

   void set( System::Drawing::Image^ )
   {
      // Insert code here.
   }
}

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

<Description("The image associated with the control"), _
    Category("Appearance")> _
Public Property MyImage() As Image
    
    Get
        ' Insert code here.
        Return image1
    End Get
    Set
        ' Insert code here.
    End Set 
End Property

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

A continuación, en el ejemplo se imprime la categoría recuperando CategoryAttribute de AttributeCollectiony escribiendola 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 = static_cast<CategoryAttribute^>(attributes[ CategoryAttribute::typeid ]);
Console::WriteLine( myAttribute->Category );

// 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);

' Gets the attributes for the property.
Dim attributes As AttributeCollection = _
    TypeDescriptor.GetProperties(Me)("MyImage").Attributes

' Prints the description by retrieving the CategoryAttribute. 
' from the AttributeCollection.
Dim myAttribute As CategoryAttribute = _
    CType(attributes(GetType(CategoryAttribute)), CategoryAttribute)
    Console.WriteLine(myAttribute.Category)

Comentarios

Un CategoryAttribute indica la categoría a la que se va a asociar la propiedad o evento asociado, al enumerar propiedades o eventos en un PropertyGrid control establecido Categorized en modo. Si no se ha aplicado un CategoryAttribute objeto a una propiedad o evento, el PropertyGrid lo asocia a la categoría Misc . Se puede crear una nueva categoría para cualquier nombre especificando el nombre de la categoría en el constructor de CategoryAttribute.

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

Notas a los desarrolladores de herederos

Si usa nombres de categoría distintos de los nombres predefinidos y desea localizar los nombres de categoría, debe invalidar el GetLocalizedString(String) método .

La CategoryAttribute clase define las siguientes categorías comunes:

Para obtener más información, consulte Attributes (Atributos).

Constructores

Propiedades

Métodos

Implementaciones de interfaz explícitas

Se aplica a

Consulte también

• Attribute
• PropertyDescriptor
• EventDescriptor