CategoryAttribute Klas

Definitie

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

Overname

Object

Attribute

CategoryAttribute

Kenmerken

AttributeUsageAttribute

Voorbeelden

In het volgende voorbeeld wordt de MyImage eigenschap gemaakt. De eigenschap heeft twee kenmerken: a DescriptionAttribute en 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

In het volgende voorbeeld wordt de categorie voor MyImage. Eerst krijgt de code een PropertyDescriptorCollection met alle eigenschappen voor het object. Vervolgens worden de code-indexen in de PropertyDescriptorCollection code geïndexeert om op te halen MyImage. Vervolgens worden de kenmerken voor deze eigenschap geretourneerd en opgeslagen in de variabele attributes.

In het voorbeeld wordt de categorie vervolgens afgedrukt door de categorie op te CategoryAttribute halen en AttributeCollectionnaar het consolescherm te schrijven.

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

Opmerkingen

A CategoryAttribute geeft de categorie aan waarmee de bijbehorende eigenschap of gebeurtenis moet worden gekoppeld, wanneer u eigenschappen of gebeurtenissen in een PropertyGrid besturingselement Categorized op de modus vermeldt. Als een CategoryAttribute eigenschap of gebeurtenis niet is toegepast op een eigenschap of gebeurtenis, wordt deze PropertyGrid gekoppeld aan de categorie Misc . Er kan een nieuwe categorie worden gemaakt voor elke naam door de naam van de categorie in de constructor voor de CategoryAttributecategorie op te geven.

De Category eigenschap geeft de naam aan van de categorie die het kenmerk vertegenwoordigt. De Category eigenschap biedt ook transparante lokalisatie van categorienamen.

Notities voor overnemers

Als u andere categorienamen dan de vooraf gedefinieerde namen gebruikt en u de categorienamen wilt lokaliseren, moet u de GetLocalizedString(String) methode overschrijven.

De CategoryAttribute klasse definieert de volgende algemene categorieën:

Zie Kenmerken voor meer informatie.

Zie ook

• Attribute
• PropertyDescriptor
• EventDescriptor