CategoryAttribute Класс

Определение

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

Наследование

Object

Attribute

CategoryAttribute

Атрибуты

AttributeUsageAttribute

Примеры

В следующем примере создается MyImage свойство . Свойство имеет два атрибута 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

В следующем примере возвращается категория для MyImage. Во-первых, код получает со PropertyDescriptorCollection всеми свойствами объекта . Затем код индексирует в для PropertyDescriptorCollection получения MyImage. Затем он возвращает атрибуты для этого свойства и сохраняет их в переменной attributes.

Затем этот пример выводит категорию, извлекая CategoryAttribute из AttributeCollectionи записывая ее на экран консоли.

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

Комментарии

Указывает CategoryAttribute категорию, с которой связывается связанное свойство или событие при перечислении свойств или событий в элементе управления, заданном PropertyGridCategorized в режиме . Если объект CategoryAttribute не был применен к свойству или событию PropertyGrid , класс связывает его с категорией Misc . Новую категорию можно создать для любого имени, указав имя категории в конструкторе CategoryAttributeдля .

Свойство Category указывает имя категории, которую представляет атрибут. Свойство Category также обеспечивает прозрачную локализацию имен категорий.

Примечания для тех, кто наследует этот метод

Если вы используете GetLocalizedString(String) имена категорий, отличные от предопределенных, и хотите локализовать имена категорий, необходимо переопределить метод .

Класс CategoryAttribute определяет следующие общие категории:

Дополнительные сведения см. в разделе Атрибуты.

Конструкторы

Свойства

Методы

Явные реализации интерфейса

Применяется к

См. также раздел

• Attribute
• PropertyDescriptor
• EventDescriptor