TypeDescriptor TypeDescriptor TypeDescriptor TypeDescriptor Class

Определение

Предоставляет сведения о характеристиках компонента, таких как его атрибуты, свойства и события.Provides information about the characteristics for a component, such as its attributes, properties, and events. Этот класс не наследуется.This class cannot be inherited.

public ref class TypeDescriptor sealed
public sealed class TypeDescriptor
type TypeDescriptor = class
Public NotInheritable Class TypeDescriptor
Наследование
TypeDescriptorTypeDescriptorTypeDescriptorTypeDescriptor

Комментарии

.NET Framework предоставляет два способа доступа к метаданным в типе: API отражения, предоставляемый в System.Reflection пространстве имен, TypeDescriptor и класс.The .NET Framework provides two ways to access metadata on a type: the reflection API provided in the System.Reflection namespace, and the TypeDescriptor class. Отражение — это общий механизм, доступный для всех типов, так как его основа устанавливается GetType в методе корневого Object класса.Reflection is a general mechanism available to all types because its foundation is established in the GetType method of the root Object class. Информация, возвращаемая для типа, не является расширяемой, поэтому ее нельзя изменить после компиляции целевого типа.The information it returns for a type is not extensible, in that it cannot be modified after compilation of the target type. Дополнительные сведения см. в разделах, посвященных отражению.For more information, see the topics in Reflection.

Напротив, TypeDescriptor — это расширяемый механизм проверки для компонентов: классы, IComponent реализующие интерфейс.In contrast, TypeDescriptor is an extensible inspection mechanism for components: those classes that implement the IComponent interface. В отличие от отражения, он не проверяет методы.Unlike reflection, it does not inspect for methods. TypeDescriptorможет динамически расширяться несколькими службами, доступными через целевой компонент Site.TypeDescriptor can be dynamically extended by several services available through the target component's Site. Эти службы показаны в следующей таблице.The following table shows these services.

Имя службыService name ОписаниеDescription
IExtenderProvider Включает другой класс, например ToolTip, для предоставления дополнительных свойств компоненту.Enables another class, such as ToolTip, to provide extra properties to a component.
ITypeDescriptorFilterService Позволяет другому объекту изменять стандартные метаданные, предоставляемые компонентом.Enables another object to modify the standard metadata that is exposed by a component.
ICustomTypeDescriptor Позволяет классу полностью и динамически задавать собственные метаданные, заменяя стандартный механизм TypeDescriptorпроверки.Enables a class to completely and dynamically specify its own metadata, replacing the standard inspection mechanism of TypeDescriptor.

Расширяемость, предоставляемая, TypeDescriptor позволяет представление компонента во время разработки отличаться от фактического представления времени выполнения, TypeDescriptor что полезно для создания инфраструктуры времени разработки.The extensibility provided by TypeDescriptor allows the design-time representation of a component to differ from its actual run-time representation, which makes TypeDescriptor useful for building design-time infrastructure.

Все методы в TypeDescriptor имеют staticзначение.All the methods in TypeDescriptor are static. Нельзя создать экземпляр этого класса, и этот класс не может быть унаследован.You cannot create an instance of this class, and this class cannot be inherited.

Можно задать значения свойств и событий двумя способами: указать их в классе Component или изменить их во время разработки.You can set property and event values two different ways: specify them in the component class or change them at design time. Поскольку эти значения можно задать двумя способами, перегруженные методы TypeDescriptor принимают два разных типа параметров: тип класса или экземпляр объекта.Because you can set these values two ways, the overloaded methods of TypeDescriptor take two different types of parameters: a class type or an object instance.

Если требуется получить доступ к TypeDescriptor информации и у вас есть экземпляр объекта, используйте метод, который вызывает для компонента.When you want to access TypeDescriptor information and you have an instance of the object, use the method that calls for a component. Используйте метод, который вызывает тип класса, только если у вас нет экземпляра объекта.Use the method that calls for the class type only when you do not have an instance of the object.

Свойства и события кэшируются в TypeDescriptor целях ускорения.Properties and events are cached by TypeDescriptor for speed. Как правило, они являются постоянными в течение времени существования объекта.Typically, they are constant for the lifetime of an object. Однако поставщики и конструкторы расширителей могут изменять набор свойств объекта.However, extender providers and designers can change the set of properties on an object. Если это так, Refresh то для обновления кэша необходимо вызвать метод.If this is the case, then the Refresh method must be called to update the cache.

Свойства

ComNativeDescriptorHandler ComNativeDescriptorHandler ComNativeDescriptorHandler ComNativeDescriptorHandler

Получает или задает поставщик сведений о типе COM для целевого компонента.Gets or sets the provider for the Component Object Model (COM) type information for the target component.

ComObjectType ComObjectType ComObjectType ComObjectType

Получает тип COM-объекта, представленный целевым компонентом.Gets the type of the Component Object Model (COM) object represented by the target component.

InterfaceType InterfaceType InterfaceType InterfaceType

Получает тип, представляющий поставщика описаний типов для всех типов интерфейса.Gets a type that represents a type description provider for all interface types.

Методы

AddAttributes(Object, Attribute[]) AddAttributes(Object, Attribute[]) AddAttributes(Object, Attribute[]) AddAttributes(Object, Attribute[])

Добавляет атрибуты уровня класса в экземпляр целевого компонента.Adds class-level attributes to the target component instance.

AddAttributes(Type, Attribute[]) AddAttributes(Type, Attribute[]) AddAttributes(Type, Attribute[]) AddAttributes(Type, Attribute[])

Добавляет атрибуты уровня класса к типу целевого компонента.Adds class-level attributes to the target component type.

AddEditorTable(Type, Hashtable) AddEditorTable(Type, Hashtable) AddEditorTable(Type, Hashtable) AddEditorTable(Type, Hashtable)

Добавляет таблицу редактора для данного базового типа редактора.Adds an editor table for the given editor base type.

AddProvider(TypeDescriptionProvider, Object) AddProvider(TypeDescriptionProvider, Object) AddProvider(TypeDescriptionProvider, Object) AddProvider(TypeDescriptionProvider, Object)

Добавляет поставщик описания типа для одного экземпляра компонента.Adds a type description provider for a single instance of a component.

AddProvider(TypeDescriptionProvider, Type) AddProvider(TypeDescriptionProvider, Type) AddProvider(TypeDescriptionProvider, Type) AddProvider(TypeDescriptionProvider, Type)

Добавляет поставщика описания типа для класса компонента.Adds a type description provider for a component class.

AddProviderTransparent(TypeDescriptionProvider, Object) AddProviderTransparent(TypeDescriptionProvider, Object) AddProviderTransparent(TypeDescriptionProvider, Object) AddProviderTransparent(TypeDescriptionProvider, Object)

Добавляет поставщик описания типа для одного экземпляра компонента.Adds a type description provider for a single instance of a component.

AddProviderTransparent(TypeDescriptionProvider, Type) AddProviderTransparent(TypeDescriptionProvider, Type) AddProviderTransparent(TypeDescriptionProvider, Type) AddProviderTransparent(TypeDescriptionProvider, Type)

Добавляет поставщика описания типа для класса компонента.Adds a type description provider for a component class.

CreateAssociation(Object, Object) CreateAssociation(Object, Object) CreateAssociation(Object, Object) CreateAssociation(Object, Object)

Создает связь "основной — дополнительный" между двумя объектами.Creates a primary-secondary association between two objects.

CreateDesigner(IComponent, Type) CreateDesigner(IComponent, Type) CreateDesigner(IComponent, Type) CreateDesigner(IComponent, Type)

Создает экземпляр конструктора, связанный с указанным компонентом указанного типа конструктора.Creates an instance of the designer associated with the specified component and of the specified type of designer.

CreateEvent(Type, EventDescriptor, Attribute[]) CreateEvent(Type, EventDescriptor, Attribute[]) CreateEvent(Type, EventDescriptor, Attribute[]) CreateEvent(Type, EventDescriptor, Attribute[])

Создает новый дескриптор события, идентичный существующему дескриптору события, при передаче существующего EventDescriptor.Creates a new event descriptor that is identical to an existing event descriptor, when passed the existing EventDescriptor.

CreateEvent(Type, String, Type, Attribute[]) CreateEvent(Type, String, Type, Attribute[]) CreateEvent(Type, String, Type, Attribute[]) CreateEvent(Type, String, Type, Attribute[])

Создает новый дескриптор события, идентичный существующему, путем динамического создания сведений о дескрипторе на основе указанного события для типа.Creates a new event descriptor that is identical to an existing event descriptor by dynamically generating descriptor information from a specified event on a type.

CreateInstance(IServiceProvider, Type, Type[], Object[]) CreateInstance(IServiceProvider, Type, Type[], Object[]) CreateInstance(IServiceProvider, Type, Type[], Object[]) CreateInstance(IServiceProvider, Type, Type[], Object[])

Создает объект, которым можно заменить другой тип данных.Creates an object that can substitute for another data type.

CreateProperty(Type, PropertyDescriptor, Attribute[]) CreateProperty(Type, PropertyDescriptor, Attribute[]) CreateProperty(Type, PropertyDescriptor, Attribute[]) CreateProperty(Type, PropertyDescriptor, Attribute[])

Создает новый дескриптор свойства из существующего свойства компонента, используя заданный существующий дескриптор PropertyDescriptor и массив атрибутов.Creates a new property descriptor from an existing property descriptor, using the specified existing PropertyDescriptor and attribute array.

CreateProperty(Type, String, Type, Attribute[]) CreateProperty(Type, String, Type, Attribute[]) CreateProperty(Type, String, Type, Attribute[]) CreateProperty(Type, String, Type, Attribute[])

Создает и динамически связывает дескриптор свойства с типом, используя указанное имя свойства, тип и массив атрибутов.Creates and dynamically binds a property descriptor to a type, using the specified property name, type, and attribute array.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetAssociation(Type, Object) GetAssociation(Type, Object) GetAssociation(Type, Object) GetAssociation(Type, Object)

Возвращает экземпляр типа, связанный с заданным основным объектом.Returns an instance of the type associated with the specified primary object.

GetAttributes(Object) GetAttributes(Object) GetAttributes(Object) GetAttributes(Object)

Возвращает коллекцию атрибутов для указанного компонента.Returns the collection of attributes for the specified component.

GetAttributes(Object, Boolean) GetAttributes(Object, Boolean) GetAttributes(Object, Boolean) GetAttributes(Object, Boolean)

Возвращает коллекцию атрибутов для указанного компонента и логическое значение, указывающее, что был создан настраиваемый дескриптор типа.Returns a collection of attributes for the specified component and a Boolean indicating that a custom type descriptor has been created.

GetAttributes(Type) GetAttributes(Type) GetAttributes(Type) GetAttributes(Type)

Возвращает коллекцию атрибутов для указанного типа компонента.Returns a collection of attributes for the specified type of component.

GetClassName(Object) GetClassName(Object) GetClassName(Object) GetClassName(Object)

Возвращает имя класса для указанного компонента, используя дескриптор типа по умолчанию.Returns the name of the class for the specified component using the default type descriptor.

GetClassName(Object, Boolean) GetClassName(Object, Boolean) GetClassName(Object, Boolean) GetClassName(Object, Boolean)

Возвращает имя класса для указанного компонента, используя дескриптор пользовательского типа.Returns the name of the class for the specified component using a custom type descriptor.

GetClassName(Type) GetClassName(Type) GetClassName(Type) GetClassName(Type)

Возвращает имя класса для указанного типа.Returns the name of the class for the specified type.

GetComponentName(Object) GetComponentName(Object) GetComponentName(Object) GetComponentName(Object)

Возвращает имя указанного компонента, используя дескриптор типа по умолчанию.Returns the name of the specified component using the default type descriptor.

GetComponentName(Object, Boolean) GetComponentName(Object, Boolean) GetComponentName(Object, Boolean) GetComponentName(Object, Boolean)

Возвращает имя указанного компонента, используя дескриптор пользовательского типа.Returns the name of the specified component using a custom type descriptor.

GetConverter(Object) GetConverter(Object) GetConverter(Object) GetConverter(Object)

Возвращает преобразователь типов для типа указанного компонента.Returns a type converter for the type of the specified component.

GetConverter(Object, Boolean) GetConverter(Object, Boolean) GetConverter(Object, Boolean) GetConverter(Object, Boolean)

Возвращает преобразователь типов для типа указанного компонента с настраиваемым дескриптором типа.Returns a type converter for the type of the specified component with a custom type descriptor.

GetConverter(Type) GetConverter(Type) GetConverter(Type) GetConverter(Type)

Возвращает преобразователь типов для указанного типа.Returns a type converter for the specified type.

GetDefaultEvent(Object) GetDefaultEvent(Object) GetDefaultEvent(Object) GetDefaultEvent(Object)

Возвращает событие по умолчанию для указанного компонента.Returns the default event for the specified component.

GetDefaultEvent(Object, Boolean) GetDefaultEvent(Object, Boolean) GetDefaultEvent(Object, Boolean) GetDefaultEvent(Object, Boolean)

Возвращает событие по умолчанию для компонента с настраиваемым дескриптором типа.Returns the default event for a component with a custom type descriptor.

GetDefaultEvent(Type) GetDefaultEvent(Type) GetDefaultEvent(Type) GetDefaultEvent(Type)

Возвращает событие по умолчанию для указанного типа компонента.Returns the default event for the specified type of component.

GetDefaultProperty(Object) GetDefaultProperty(Object) GetDefaultProperty(Object) GetDefaultProperty(Object)

Возвращает свойство по умолчанию для указанного компонента.Returns the default property for the specified component.

GetDefaultProperty(Object, Boolean) GetDefaultProperty(Object, Boolean) GetDefaultProperty(Object, Boolean) GetDefaultProperty(Object, Boolean)

Возвращает свойство по умолчанию для указанного компонента с настраиваемым дескриптором типа.Returns the default property for the specified component with a custom type descriptor.

GetDefaultProperty(Type) GetDefaultProperty(Type) GetDefaultProperty(Type) GetDefaultProperty(Type)

Возвращает свойство по умолчанию для указанного типа компонента.Returns the default property for the specified type of component.

GetEditor(Object, Type) GetEditor(Object, Type) GetEditor(Object, Type) GetEditor(Object, Type)

Получает редактор с заданным базовым типом для указанного компонента.Gets an editor with the specified base type for the specified component.

GetEditor(Object, Type, Boolean) GetEditor(Object, Type, Boolean) GetEditor(Object, Type, Boolean) GetEditor(Object, Type, Boolean)

Возвращает редактор с заданным базовым типом и настраиваемым дескриптором типа для указанного компонента.Returns an editor with the specified base type and with a custom type descriptor for the specified component.

GetEditor(Type, Type) GetEditor(Type, Type) GetEditor(Type, Type) GetEditor(Type, Type)

Получает редактор с заданным базовым типом для указанного компонента.Returns an editor with the specified base type for the specified type.

GetEvents(Object) GetEvents(Object) GetEvents(Object) GetEvents(Object)

Возвращает коллекцию событий для указанного компонента.Returns the collection of events for the specified component.

GetEvents(Object, Attribute[]) GetEvents(Object, Attribute[]) GetEvents(Object, Attribute[]) GetEvents(Object, Attribute[])

Возвращает коллекцию событий для указанного компонента, используя заданный массив атрибутов в качестве фильтра.Returns the collection of events for a specified component using a specified array of attributes as a filter.

GetEvents(Object, Attribute[], Boolean) GetEvents(Object, Attribute[], Boolean) GetEvents(Object, Attribute[], Boolean) GetEvents(Object, Attribute[], Boolean)

Возвращает коллекцию событий для указанного компонента, используя заданный массив атрибутов в качестве фильтра и используя пользовательский дескриптор типа.Returns the collection of events for a specified component using a specified array of attributes as a filter and using a custom type descriptor.

GetEvents(Object, Boolean) GetEvents(Object, Boolean) GetEvents(Object, Boolean) GetEvents(Object, Boolean)

Возвращает коллекцию событий для указанного компонента с дескриптором пользовательского типа.Returns the collection of events for a specified component with a custom type descriptor.

GetEvents(Type) GetEvents(Type) GetEvents(Type) GetEvents(Type)

Возвращает коллекцию событий для указанного типа компонента.Returns the collection of events for a specified type of component.

GetEvents(Type, Attribute[]) GetEvents(Type, Attribute[]) GetEvents(Type, Attribute[]) GetEvents(Type, Attribute[])

Возвращает коллекцию событий для указанного типа компонента, используя заданный массив атрибутов в качестве фильтра.Returns the collection of events for a specified type of component using a specified array of attributes as a filter.

GetFullComponentName(Object) GetFullComponentName(Object) GetFullComponentName(Object) GetFullComponentName(Object)

Возвращает полное имя компонента.Returns the fully qualified name of the component.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Inherited from Object)
GetProperties(Object) GetProperties(Object) GetProperties(Object) GetProperties(Object)

Возвращает коллекцию свойств для указанного компонента.Returns the collection of properties for a specified component.

GetProperties(Object, Attribute[]) GetProperties(Object, Attribute[]) GetProperties(Object, Attribute[]) GetProperties(Object, Attribute[])

Возвращает коллекцию свойств для указанного компонента, используя заданный массив атрибутов в качестве фильтра.Returns the collection of properties for a specified component using a specified array of attributes as a filter.

GetProperties(Object, Attribute[], Boolean) GetProperties(Object, Attribute[], Boolean) GetProperties(Object, Attribute[], Boolean) GetProperties(Object, Attribute[], Boolean)

Возвращает коллекцию свойств для указанного компонента, используя заданный массив атрибутов в качестве фильтра и пользовательский дескриптор типа.Returns the collection of properties for a specified component using a specified array of attributes as a filter and using a custom type descriptor.

GetProperties(Object, Boolean) GetProperties(Object, Boolean) GetProperties(Object, Boolean) GetProperties(Object, Boolean)

Возвращает коллекцию свойств для указанного компонента, используя дескриптор типа по умолчанию.Returns the collection of properties for a specified component using the default type descriptor.

GetProperties(Type) GetProperties(Type) GetProperties(Type) GetProperties(Type)

Возвращает коллекцию свойств для указанного типа компонента.Returns the collection of properties for a specified type of component.

GetProperties(Type, Attribute[]) GetProperties(Type, Attribute[]) GetProperties(Type, Attribute[]) GetProperties(Type, Attribute[])

Возвращает коллекцию свойств для указанного типа компонента, используя заданный массив атрибутов в качестве фильтра.Returns the collection of properties for a specified type of component using a specified array of attributes as a filter.

GetProvider(Object) GetProvider(Object) GetProvider(Object) GetProvider(Object)

Возвращает поставщик описания типа для указанного компонента.Returns the type description provider for the specified component.

GetProvider(Type) GetProvider(Type) GetProvider(Type) GetProvider(Type)

Возвращает поставщик описания типа для указанного типа.Returns the type description provider for the specified type.

GetReflectionType(Object) GetReflectionType(Object) GetReflectionType(Object) GetReflectionType(Object)

Возвращает тип Type, который может использоваться для выполнения отражения, используя объект.Returns a Type that can be used to perform reflection, given an object.

GetReflectionType(Type) GetReflectionType(Type) GetReflectionType(Type) GetReflectionType(Type)

Возвращает тип Type, который может использоваться для выполнения отражения, используя тип класса.Returns a Type that can be used to perform reflection, given a class type.

GetType() GetType() GetType() GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Inherited from Object)
Refresh(Assembly) Refresh(Assembly) Refresh(Assembly) Refresh(Assembly)

Удаляет свойства и события для указанной сборки из кэша.Clears the properties and events for the specified assembly from the cache.

Refresh(Module) Refresh(Module) Refresh(Module) Refresh(Module)

Удаляет свойства и события для указанного модуля из кэша.Clears the properties and events for the specified module from the cache.

Refresh(Object) Refresh(Object) Refresh(Object) Refresh(Object)

Удаляет свойства и события для указанного компонента из кэша.Clears the properties and events for the specified component from the cache.

Refresh(Type) Refresh(Type) Refresh(Type) Refresh(Type)

Удаляет свойства и события для указанного типа компонента из кэша.Clears the properties and events for the specified type of component from the cache.

RemoveAssociation(Object, Object) RemoveAssociation(Object, Object) RemoveAssociation(Object, Object) RemoveAssociation(Object, Object)

Удаляет ассоциацию между двумя объектами.Removes an association between two objects.

RemoveAssociations(Object) RemoveAssociations(Object) RemoveAssociations(Object) RemoveAssociations(Object)

Удаляет все ассоциации для основного объекта.Removes all associations for a primary object.

RemoveProvider(TypeDescriptionProvider, Object) RemoveProvider(TypeDescriptionProvider, Object) RemoveProvider(TypeDescriptionProvider, Object) RemoveProvider(TypeDescriptionProvider, Object)

Удаляет ранее добавленный поставщик описания типа, связанный с указанным объектом.Removes a previously added type description provider that is associated with the specified object.

RemoveProvider(TypeDescriptionProvider, Type) RemoveProvider(TypeDescriptionProvider, Type) RemoveProvider(TypeDescriptionProvider, Type) RemoveProvider(TypeDescriptionProvider, Type)

Удаляет ранее добавленный поставщик описания типа, связанный с указанным типом.Removes a previously added type description provider that is associated with the specified type.

RemoveProviderTransparent(TypeDescriptionProvider, Object) RemoveProviderTransparent(TypeDescriptionProvider, Object) RemoveProviderTransparent(TypeDescriptionProvider, Object) RemoveProviderTransparent(TypeDescriptionProvider, Object)

Удаляет ранее добавленный поставщик описания типа, связанный с указанным объектом.Removes a previously added type description provider that is associated with the specified object.

RemoveProviderTransparent(TypeDescriptionProvider, Type) RemoveProviderTransparent(TypeDescriptionProvider, Type) RemoveProviderTransparent(TypeDescriptionProvider, Type) RemoveProviderTransparent(TypeDescriptionProvider, Type)

Удаляет ранее добавленный поставщик описания типа, связанный с указанным типом.Removes a previously added type description provider that is associated with the specified type.

SortDescriptorArray(IList) SortDescriptorArray(IList) SortDescriptorArray(IList) SortDescriptorArray(IList)

Сортирует дескрипторы по их именам.Sorts descriptors using the name of the descriptor.

ToString() ToString() ToString() ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Inherited from Object)

События

Refreshed Refreshed Refreshed Refreshed

Возникает при очистке кэша для компонента.Occurs when the cache for a component is cleared.

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

Дополнительно