CategoryAttribute Classe

Definição

public ref class CategoryAttribute : Attribute

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

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

Public Class CategoryAttribute
Inherits Attribute

Herança

Object

Attribute

CategoryAttribute

Atributos

AttributeUsageAttribute

Exemplos

O exemplo seguinte cria a MyImage propriedade. A propriedade tem dois atributos: a DescriptionAttribute e a 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 exemplo seguinte obtém a categoria para MyImage. Primeiro, o código recebe a PropertyDescriptorCollection com todas as propriedades do objeto. De seguida, o código indexa-se para obter PropertyDescriptorCollectionMyImage. Depois, devolve os atributos desta propriedade e guarda-os na variável attributes.

O exemplo imprime então a categoria recuperando-a CategoryAttribute do AttributeCollection, e escrevendo-a no ecrã da 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)

Observações

A indica a categoria a associar a propriedade ou evento associado, ao listar CategoryAttribute propriedades ou eventos num PropertyGrid controlo definido para Categorized modo. Se a CategoryAttribute não tiver sido aplicado a uma propriedade ou evento, associa-o PropertyGrid à categoria Misc . Pode ser criada uma nova categoria 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 proporciona uma localização transparente dos nomes das categorias.

Notas para Herdeiros

Se usar nomes de categorias diferentes dos pré-definidos e quiser localizar os nomes das suas categorias, deve sobrescrever o GetLocalizedString(String) método.

A CategoryAttribute classe define as seguintes categorias comuns:

Para obter mais informações, consulte Atributos.

Ver também

• Attribute
• PropertyDescriptor
• EventDescriptor