TypeDescriptor TypeDescriptor TypeDescriptor TypeDescriptor Class

Definition

Proporciona información sobre las características de un componente, como sus atributos, propiedades y eventos. Provides information about the characteristics for a component, such as its attributes, properties, and events. Esta clase no puede heredarse. This class cannot be inherited.

public ref class TypeDescriptor sealed
public sealed class TypeDescriptor
type TypeDescriptor = class
Public NotInheritable Class TypeDescriptor
Inheritance
TypeDescriptorTypeDescriptorTypeDescriptorTypeDescriptor

Remarks

.NET Framework proporciona dos maneras de acceder a los metadatos de un tipo: la reflexión proporciona API en el System.Reflection espacio de nombres y el TypeDescriptor clase.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. Reflexión es un mecanismo general disponible para todos los tipos porque su base se establece en el GetType método de la raíz Object clase.Reflection is a general mechanism available to all types because its foundation is established in the GetType method of the root Object class. La información que se devuelve para un tipo no es extensible, en que no se puede modificar después de la compilación del tipo de destino.The information it returns for a type is not extensible, in that it cannot be modified after compilation of the target type. Para obtener más información, vea los temas de reflexión.For more information, see the topics in Reflection.

En cambio, TypeDescriptor es un mecanismo de inspección extensible para componentes: las clases que implementan la IComponent interfaz.In contrast, TypeDescriptor is an extensible inspection mechanism for components: those classes that implement the IComponent interface. A diferencia de la reflexión, no inspecciona los métodos.Unlike reflection, it does not inspect for methods. TypeDescriptor se puede ampliar dinámicamente mediante varios servicios disponibles a través del componente de destino Site.TypeDescriptor can be dynamically extended by several services available through the target component's Site. En la tabla siguiente se muestra estos servicios.The following table shows these services.

Nombre del servicioService name DescripciónDescription
IExtenderProvider Habilita otra clase, como ToolTip, para proporcionar propiedades adicionales a un componente.Enables another class, such as ToolTip, to provide extra properties to a component.
ITypeDescriptorFilterService Permite que otro objeto modificar los metadatos estándar que se exponen mediante un componente.Enables another object to modify the standard metadata that is exposed by a component.
ICustomTypeDescriptor Permite que una clase dinámicamente y completamente especificar sus propios metadatos, reemplazando el mecanismo estándar de inspección de TypeDescriptor.Enables a class to completely and dynamically specify its own metadata, replacing the standard inspection mechanism of TypeDescriptor.

La extensibilidad proporcionadas por TypeDescriptor permite la representación en tiempo de diseño de un componente difiera de su representación de tiempo de ejecución real, lo que hace que TypeDescriptor útil para crear la infraestructura en tiempo de diseño.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.

Todos los métodos de TypeDescriptor son static.All the methods in TypeDescriptor are static. No se puede crear una instancia de esta clase y no se puede heredar esta clase.You cannot create an instance of this class, and this class cannot be inherited.

Puede establecer la propiedad y valores de dos formas diferentes de los eventos: especificarlos en la clase de componente o cambiarlos en tiempo de diseño.You can set property and event values two different ways: specify them in the component class or change them at design time. Dado que puede establecer estos valores de dos formas, los métodos sobrecargados de TypeDescriptor realizar dos tipos diferentes de parámetros: un tipo de clase o una instancia de objeto.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.

Si desea tener acceso a TypeDescriptor información y tiene una instancia del objeto, utilice el método que llama a un componente.When you want to access TypeDescriptor information and you have an instance of the object, use the method that calls for a component. Utilice el método que llama al tipo de clase sólo cuando no tiene una instancia del objeto.Use the method that calls for the class type only when you do not have an instance of the object.

Propiedades y eventos se almacenan en caché por TypeDescriptor para acelerar el proceso.Properties and events are cached by TypeDescriptor for speed. Normalmente, son constantes durante la vigencia de un objeto.Typically, they are constant for the lifetime of an object. Sin embargo, los diseñadores y los proveedores extensores pueden cambiar el conjunto de propiedades en un objeto.However, extender providers and designers can change the set of properties on an object. Si es así, el Refresh método debe llamarse para actualizar la memoria caché.If this is the case, then the Refresh method must be called to update the cache.

Properties

ComNativeDescriptorHandler ComNativeDescriptorHandler ComNativeDescriptorHandler ComNativeDescriptorHandler

Obtiene o establece el proveedor de la información de tipos COM (Component Object Model, Modelo de objetos componentes) del componente de destino. Gets or sets the provider for the Component Object Model (COM) type information for the target component.

ComObjectType ComObjectType ComObjectType ComObjectType

Obtiene el tipo del objeto COM (Component Object Model, Modelo de objetos componentes) que representa el componente de destino. Gets the type of the Component Object Model (COM) object represented by the target component.

InterfaceType InterfaceType InterfaceType InterfaceType

Obtiene un tipo que representa un proveedor de descripción de tipo para todos los tipos de interfaz. Gets a type that represents a type description provider for all interface types.

Methods

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

Agrega atributos de nivel de clase a la instancia del componente de destino. Adds class-level attributes to the target component instance.

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

Agrega atributos de nivel de clase al tipo del componente de destino. Adds class-level attributes to the target component type.

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

Agrega una tabla de editor para el tipo base de editor determinado. Adds an editor table for the given editor base type.

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

Agrega un proveedor de descripción de tipos para una única instancia de un componente. Adds a type description provider for a single instance of a component.

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

Agrega un proveedor de descripción de tipos para una clase de componentes. Adds a type description provider for a component class.

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

Agrega un proveedor de descripción de tipos para una única instancia de un componente. Adds a type description provider for a single instance of a component.

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

Agrega un proveedor de descripción de tipos para una clase de componentes. Adds a type description provider for a component class.

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

Crea una asociación de principal-secundario entre dos objetos. Creates a primary-secondary association between two objects.

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

Crea una instancia del diseñador asociado al componente especificado y del tipo especificado de diseñador. 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[])

Crea un nuevo descriptor de eventos que es idéntico a otro existente, una vez pasado el EventDescriptor existente. 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[])

Crea un nuevo descriptor de eventos que es idéntico a otro existente generando dinámicamente la información sobre descriptores a partir de un evento especificado en un tipo. 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[])

Crea un objeto que puede sustituir a otro tipo de datos. 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[])

Crea un nuevo descriptor de propiedades a partir de un descriptor de propiedades existente, utilizando la matriz de atributos y el objeto PropertyDescriptor existentes especificados. 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[])

Crea un descriptor de propiedades y lo enlaza dinámicamente a un tipo, utilizando el nombre de propiedad, el tipo y la matriz de atributos especificados. 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)

Determina si el objeto especificado es igual al objeto actual. 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)

Devuelve una instancia del tipo asociado al objeto principal especificado. Returns an instance of the type associated with the specified primary object.

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

Devuelve la colección de atributos para el componente especificado. Returns the collection of attributes for the specified component.

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

Devuelve una colección de atributos para el componente especificado, así como un valor Boolean que indica que se ha creado un descriptor de tipos personalizado. 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)

Devuelve una colección de atributos para el tipo de componente especificado. Returns a collection of attributes for the specified type of component.

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

Devuelve el nombre de la clase para el componente especificado utilizando el descriptor de tipos predeterminado. 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)

Devuelve el nombre de la clase para el componente especificado utilizando un descriptor de tipos personalizado. Returns the name of the class for the specified component using a custom type descriptor.

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

Devuelve el nombre de la clase para el tipo especificado. Returns the name of the class for the specified type.

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

Devuelve el nombre del componente especificado utilizando el descriptor de tipos predeterminado. Returns the name of the specified component using the default type descriptor.

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

Devuelve el nombre del componente especificado utilizando un descriptor de tipos personalizado. Returns the name of the specified component using a custom type descriptor.

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

Devuelve un convertidor de tipos para el tipo del componente especificado. Returns a type converter for the type of the specified component.

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

Devuelve un convertidor de tipos para el tipo del componente especificado con un descriptor de tipos personalizado. Returns a type converter for the type of the specified component with a custom type descriptor.

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

Devuelve un convertidor de tipos para el tipo especificado. Returns a type converter for the specified type.

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

Devuelve el evento predeterminado para el componente especificado. Returns the default event for the specified component.

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

Devuelve el evento predeterminado para un componente con un descriptor de tipos personalizado. Returns the default event for a component with a custom type descriptor.

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

Devuelve el evento predeterminado para el tipo especificado de componente. Returns the default event for the specified type of component.

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

Devuelve la propiedad predeterminada para el componente especificado. Returns the default property for the specified component.

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

Devuelve la propiedad predeterminada para el componente especificado con un descriptor de tipos personalizado. Returns the default property for the specified component with a custom type descriptor.

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

Devuelve la propiedad predeterminada para el tipo de componente especificado. Returns the default property for the specified type of component.

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

Obtiene un editor con el tipo base especificado para el componente especificado. 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)

Devuelve un editor con el tipo base especificado y con un descriptor de tipos personalizado para el componente especificado. 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)

Devuelve un editor con el tipo base determinado para el tipo especificado. Returns an editor with the specified base type for the specified type.

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

Devuelve la colección de eventos para el componente especificado. Returns the collection of events for the specified component.

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

Devuelve la colección de eventos para un componente especificado utilizando una matriz de atributos determinada que sirve como filtro. 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)

Devuelve la colección de eventos para un componente especificado utilizando una matriz de atributos determinada que sirve como filtro y un descriptor de tipos personalizado. 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)

Devuelve la colección de eventos para un componente especificado con un descriptor de tipos personalizado. Returns the collection of events for a specified component with a custom type descriptor.

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

Devuelve la colección de eventos para un tipo especificado de componente. Returns the collection of events for a specified type of component.

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

Devuelve la colección de eventos para un tipo de componente especificado utilizando una matriz de atributos determinada que sirve como filtro. 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)

Devuelve el nombre completo del componente. Returns the fully qualified name of the component.

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

Sirve como la función hash predeterminada. Serves as the default hash function.

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

Devuelve la colección de propiedades para un componente especificado. Returns the collection of properties for a specified component.

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

Devuelve la colección de propiedades para un componente especificado utilizando una matriz de atributos determinada que sirve como filtro. 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)

Devuelve la colección de propiedades para un componente especificado utilizando una matriz de atributos determinada que sirve como filtro y un descriptor de tipos personalizado. 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)

Devuelve la colección de propiedades para un componente especificado utilizando el descriptor de tipos predeterminado. Returns the collection of properties for a specified component using the default type descriptor.

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

Devuelve la colección de propiedades para un tipo especificado de componente. Returns the collection of properties for a specified type of component.

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

Devuelve la colección de propiedades para un tipo de componente especificado utilizando una matriz de atributos determinada que sirve como filtro. 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)

Devuelve el proveedor de descripción de tipos para el componente especificado. Returns the type description provider for the specified component.

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

Devuelve el proveedor de descripción de tipos para el tipo especificado. Returns the type description provider for the specified type.

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

Devuelve un objeto Type que se puede utilizar para llevar a cabo la reflexión teniendo en cuenta un objeto. Returns a Type that can be used to perform reflection, given an object.

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

Devuelve un objeto Type que se puede utilizar para realizar la reflexión teniendo en cuenta un tipo de clase. Returns a Type that can be used to perform reflection, given a class type.

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

Obtiene el Type de la instancia actual. Gets the Type of the current instance.

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

Crea una copia superficial del Object actual. Creates a shallow copy of the current Object.

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

Borra de la memoria caché las propiedades y los eventos correspondientes al ensamblado especificado. Clears the properties and events for the specified assembly from the cache.

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

Borra de la memoria caché las propiedades y los eventos correspondientes al módulo especificado. Clears the properties and events for the specified module from the cache.

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

Borra de la memoria caché las propiedades y los eventos correspondientes al componente especificado. Clears the properties and events for the specified component from the cache.

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

Borra de la memoria caché las propiedades y los eventos correspondientes al tipo de componente especificado. 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)

Quita una asociación entre dos objetos. Removes an association between two objects.

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

Quita todas las asociaciones de un objeto principal. Removes all associations for a primary object.

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

Quita un proveedor de descripción de tipos previamente agregado que está asociado al objeto especificado. 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)

Quita un proveedor de descripción de tipos previamente agregado que está asociado al tipo especificado. 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)

Quita un proveedor de descripción de tipos previamente agregado que está asociado al objeto especificado. 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)

Quita un proveedor de descripción de tipos previamente agregado que está asociado al tipo especificado. Removes a previously added type description provider that is associated with the specified type.

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

Ordena los descriptores utilizando el nombre del descriptor. Sorts descriptors using the name of the descriptor.

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

Devuelve una cadena que representa el objeto actual. Returns a string that represents the current object.

(Inherited from Object)

Events

Refreshed Refreshed Refreshed Refreshed

Se produce cuando se borra la caché de un componente. Occurs when the cache for a component is cleared.

Applies to

See Also