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.

Можно задать свойства и события значения двумя разными способами: указать их в классе компонента или изменить их во время разработки.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.

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

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