TypeDescriptor.GetAttributes Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает коллекцию атрибутов для компонента или типа.
Перегрузки
GetAttributes(Object) |
Возвращает коллекцию атрибутов для указанного компонента. |
GetAttributes(Type) |
Возвращает коллекцию атрибутов для указанного типа компонента. |
GetAttributes(Object, Boolean) |
Возвращает коллекцию атрибутов для указанного компонента и логическое значение, указывающее, что был создан настраиваемый дескриптор типа. |
GetAttributes(Object)
Возвращает коллекцию атрибутов для указанного компонента.
public:
static System::ComponentModel::AttributeCollection ^ GetAttributes(System::Object ^ component);
public static System.ComponentModel.AttributeCollection GetAttributes (object component);
static member GetAttributes : obj -> System.ComponentModel.AttributeCollection
Public Shared Function GetAttributes (component As Object) As AttributeCollection
Параметры
- component
- Object
Компонент, для которого требуется получить атрибуты.
Возвращаемое значение
Коллекция AttributeCollection, содержащая атрибуты для этого компонента. Если параметр component
имеет значение null
, этот метод возвращает пустую коллекцию.
Примеры
Пример этого метода см. в описании Matches метода.
Комментарии
Атрибуты, GetAttributes возвращаемые методом, могут динамически изменяться из исходного описания исходного компонента поставщиками расширителя (IExtenderProvider), службами фильтрации (ITypeDescriptorFilterService) и фильтрами атрибутов.
При определении настраиваемого атрибута с AttributeUsageAttribute.AllowMultiple заданным true
значением необходимо переопределить Attribute.TypeId свойство, чтобы сделать его уникальным. Если все экземпляры атрибута уникальны, переопределите Attribute.TypeId , чтобы вернуть удостоверение объекта атрибута. Если только некоторые экземпляры атрибута уникальны, возвращает значение из Attribute.TypeId этого значения, возвращающее равенство в этих случаях. Например, некоторые атрибуты имеют параметр конструктора, который выступает в качестве уникального ключа. Для этих атрибутов возвращает значение параметра конструктора из Attribute.TypeId свойства.
Примечание
Реализация Attribute.TypeId по умолчанию возвращает удостоверение типа независимо от значения AttributeUsageAttribute.AllowMultiple свойства. Чтобы вернуть из него несколько экземпляров AttributeUsageAttribute.AllowMultiple атрибута AttributeCollection, атрибут должен переопределить Attribute.TypeId свойство.
См. также раздел
Применяется к
GetAttributes(Type)
Возвращает коллекцию атрибутов для указанного типа компонента.
public:
static System::ComponentModel::AttributeCollection ^ GetAttributes(Type ^ componentType);
public static System.ComponentModel.AttributeCollection GetAttributes (Type componentType);
static member GetAttributes : Type -> System.ComponentModel.AttributeCollection
Public Shared Function GetAttributes (componentType As Type) As AttributeCollection
Параметры
Возвращаемое значение
Коллекция AttributeCollection, содержащая атрибуты для данного типа компонента. Если компонент — null
, этот метод возвращает пустую коллекцию.
Комментарии
Вызовите эту версию этого метода только в том случае, если у вас нет экземпляра объекта.
Для атрибутов с заданным AttributeUsageAttribute.AllowMultiple значением true
коллекция атрибутов удаляет повторяющиеся экземпляры. Это экземпляры, в которых Attribute.TypeId свойство возвращает равные значения.
При определении настраиваемого атрибута с AttributeUsageAttribute.AllowMultiple заданным true
значением необходимо переопределить Attribute.TypeId свойство, чтобы сделать его уникальным. Если все экземпляры атрибута уникальны, переопределите Attribute.TypeId , чтобы вернуть удостоверение объекта атрибута. Если только некоторые экземпляры атрибута уникальны, возвращает значение из Attribute.TypeId этого значения, возвращающее равенство в этих случаях. Например, некоторые атрибуты имеют параметр конструктора, который выступает в качестве уникального ключа. Для этих атрибутов возвращает значение параметра конструктора из Attribute.TypeId свойства.
Примечание
Реализация Attribute.TypeId по умолчанию возвращает удостоверение типа независимо от значения AttributeUsageAttribute.AllowMultiple свойства. Чтобы вернуть из него несколько экземпляров AttributeUsageAttribute.AllowMultiple атрибута AttributeCollection, атрибут должен переопределить Attribute.TypeId свойство.
См. также раздел
Применяется к
GetAttributes(Object, Boolean)
Возвращает коллекцию атрибутов для указанного компонента и логическое значение, указывающее, что был создан настраиваемый дескриптор типа.
public:
static System::ComponentModel::AttributeCollection ^ GetAttributes(System::Object ^ component, bool noCustomTypeDesc);
public static System.ComponentModel.AttributeCollection GetAttributes (object component, bool noCustomTypeDesc);
static member GetAttributes : obj * bool -> System.ComponentModel.AttributeCollection
Public Shared Function GetAttributes (component As Object, noCustomTypeDesc As Boolean) As AttributeCollection
Параметры
- component
- Object
Компонент, для которого требуется получить атрибуты.
- noCustomTypeDesc
- Boolean
Значение true
, чтобы использовать базовый набор атрибутов из настраиваемого дескриптора типа, если component
имеет тип ICustomTypeDescriptor; в противном случае — значение false
.
Возвращаемое значение
Коллекция AttributeCollection, содержащая атрибуты для данного компонента. Если компонент — null
, этот метод возвращает пустую коллекцию.
Комментарии
Атрибуты, GetAttributes возвращаемые методом, могут динамически изменяться из исходного списка исходных компонентов поставщиками расширителя (IExtenderProvider), службами фильтрации (ITypeDescriptorFilterService) и фильтрами атрибутов.
При определении настраиваемого атрибута с AttributeUsageAttribute.AllowMultiple заданным true
значением необходимо переопределить Attribute.TypeId свойство, чтобы сделать его уникальным. Если все экземпляры атрибута уникальны, переопределите Attribute.TypeId , чтобы вернуть удостоверение объекта атрибута. Если только некоторые экземпляры атрибута уникальны, возвращает значение из Attribute.TypeId этого значения, возвращающее равенство в этих случаях. Например, некоторые атрибуты имеют параметр конструктора, который выступает в качестве уникального ключа. Для этих атрибутов возвращает значение параметра конструктора из Attribute.TypeId свойства.
Примечание
Реализация Attribute.TypeId по умолчанию возвращает удостоверение типа независимо от значения AttributeUsageAttribute.AllowMultiple свойства. Чтобы вернуть из него несколько экземпляров AttributeUsageAttribute.AllowMultiple атрибута AttributeCollection, атрибут должен переопределить Attribute.TypeId свойство.
См. также раздел
- Attribute
- AttributeCollection
- ICustomTypeDescriptor
- GetAttributes()
- AddAttributes
- GetEvents
- GetProperties