CategoryAttribute Classe

Definição

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

Herança

Object

Attribute

CategoryAttribute

Atributos

AttributeUsageAttribute

Exemplos

O exemplo a seguir cria a MyImage propriedade. A propriedade tem dois atributos: a DescriptionAttribute e um 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.
        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

O próximo exemplo obtém a categoria para MyImage. Primeiro, o código obtém uma PropertyDescriptorCollection com todas as propriedades do objeto. Em seguida, o código indexa no PropertyDescriptorCollection para obter MyImage. Em seguida, retorna os atributos dessa propriedade e os salva na variável attributes.

Em seguida, o exemplo imprime a categoria recuperando-a AttributeCollectione gravando-a CategoryAttribute na tela do console.

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

Comentários

Um CategoryAttribute indica a categoria à qual associar a propriedade ou evento associado, ao listar propriedades ou eventos em um PropertyGrid controle definido como Categorized modo. Se um CategoryAttribute não tiver sido aplicado a uma propriedade ou evento, o PropertyGrid associará à categoria Misc . Uma nova categoria pode ser criada para qualquer nome especificando o nome da categoria no construtor para o CategoryAttribute.

A Category propriedade indica o nome da categoria que o atributo representa. A Category propriedade também fornece localização transparente de nomes de categoria.

Notas aos Herdeiros

Se você usar nomes de categoria diferentes dos nomes predefinidos e quiser localizar seus nomes de categoria, deverá substituir o GetLocalizedString(String) método.

A CategoryAttribute classe define as seguintes categorias comuns:

Para obter mais informações, consulte Atributos.

Confira também

• Attribute
• PropertyDescriptor
• EventDescriptor