TypeDescriptor TypeDescriptor TypeDescriptor TypeDescriptor Class

Définition

Fournit des informations relatives aux caractéristiques d’un composant, telles que ses attributs, ses propriétés et ses événements.Provides information about the characteristics for a component, such as its attributes, properties, and events. Cette classe ne peut pas être héritée.This class cannot be inherited.

public ref class TypeDescriptor sealed
public sealed class TypeDescriptor
type TypeDescriptor = class
Public NotInheritable Class TypeDescriptor
Héritage
TypeDescriptorTypeDescriptorTypeDescriptorTypeDescriptor

Remarques

L' .NET Framework offre deux façons d’accéder aux métadonnées d’un type : l’API de réflexion System.Reflection fournie dans l’espace TypeDescriptor de noms et la classe.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. La réflexion est un mécanisme général disponible pour tous les types, car sa fondation est GetType établie dans la méthode Object de la classe racine.Reflection is a general mechanism available to all types because its foundation is established in the GetType method of the root Object class. Les informations retournées pour un type ne sont pas extensibles, car elles ne peuvent pas être modifiées après la compilation du type cible.The information it returns for a type is not extensible, in that it cannot be modified after compilation of the target type. Pour plus d’informations, consultez les rubriques dans la réflexion.For more information, see the topics in Reflection.

En revanche, TypeDescriptor est un mécanisme d’inspection extensible pour les composants : les classes qui IComponent implémentent l’interface.In contrast, TypeDescriptor is an extensible inspection mechanism for components: those classes that implement the IComponent interface. Contrairement à la réflexion, elle n’examine pas les méthodes.Unlike reflection, it does not inspect for methods. TypeDescriptorpeut être étendu de manière dynamique par plusieurs services disponibles via le du Sitecomposant cible.TypeDescriptor can be dynamically extended by several services available through the target component's Site. Le tableau suivant présente ces services.The following table shows these services.

Nom du serviceService name DescriptionDescription
IExtenderProvider Permet à une autre classe, ToolTiptelle que, de fournir des propriétés supplémentaires à un composant.Enables another class, such as ToolTip, to provide extra properties to a component.
ITypeDescriptorFilterService Permet à un autre objet de modifier les métadonnées standard exposées par un composant.Enables another object to modify the standard metadata that is exposed by a component.
ICustomTypeDescriptor Permet à une classe de spécifier de manière complète et dynamique ses propres métadonnées, en remplaçant le TypeDescriptormécanisme d’inspection standard de.Enables a class to completely and dynamically specify its own metadata, replacing the standard inspection mechanism of TypeDescriptor.

L’extensibilité fournie par TypeDescriptor permet à la représentation au moment du design d’un composant d’être différente de sa représentation réelle au moment de TypeDescriptor l’exécution, ce qui rend utile la génération de l’infrastructure au moment du Design.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.

Toutes les méthodes dans TypeDescriptor sont static.All the methods in TypeDescriptor are static. Vous ne pouvez pas créer une instance de cette classe et cette classe ne peut pas être héritée.You cannot create an instance of this class, and this class cannot be inherited.

Vous pouvez définir des valeurs de propriété et d’événement de deux façons différentes : spécifiez-les dans la classe de composant ou modifiez-les au moment du Design.You can set property and event values two different ways: specify them in the component class or change them at design time. Étant donné que vous pouvez définir ces valeurs de deux manières, les méthodes surchargées de TypeDescriptor prennent deux types de paramètres différents : un type de classe ou une instance d’objet.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.

Lorsque vous souhaitez accéder aux TypeDescriptor informations et que vous disposez d’une instance de l’objet, utilisez la méthode qui appelle un composant.When you want to access TypeDescriptor information and you have an instance of the object, use the method that calls for a component. Utilisez la méthode qui appelle pour le type de classe uniquement lorsque vous n’avez pas d’instance de l’objet.Use the method that calls for the class type only when you do not have an instance of the object.

Les propriétés et les événements sont mis TypeDescriptor en cache par pour la vitesse.Properties and events are cached by TypeDescriptor for speed. En règle générale, elles sont constantes pendant la durée de vie d’un objet.Typically, they are constant for the lifetime of an object. Toutefois, les fournisseurs d’extendeurs et les concepteurs peuvent modifier le jeu de propriétés sur un objet.However, extender providers and designers can change the set of properties on an object. Si c’est le cas, la Refresh méthode doit être appelée pour mettre à jour le cache.If this is the case, then the Refresh method must be called to update the cache.

Propriétés

ComNativeDescriptorHandler ComNativeDescriptorHandler ComNativeDescriptorHandler ComNativeDescriptorHandler

Obtient ou définit le fournisseur pour les informations de type COM (Component Object Model) pour le composant cible.Gets or sets the provider for the Component Object Model (COM) type information for the target component.

ComObjectType ComObjectType ComObjectType ComObjectType

Obtient le type de l’objet COM (Component Object Model) représenté par le composant cible.Gets the type of the Component Object Model (COM) object represented by the target component.

InterfaceType InterfaceType InterfaceType InterfaceType

Obtient un type qui représente un fournisseur de description de type pour tous les types d'interface.Gets a type that represents a type description provider for all interface types.

Méthodes

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

Ajoute des attributs de niveau classe à l’instance du composant cible.Adds class-level attributes to the target component instance.

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

Ajoute des attributs de classe au type du composant cible.Adds class-level attributes to the target component type.

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

Ajoute une table d’éditeur pour le type de base d’éditeur donné.Adds an editor table for the given editor base type.

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

Ajoute un fournisseur de description de type pour une instance unique d’un composant.Adds a type description provider for a single instance of a component.

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

Ajoute un fournisseur de description de type pour une classe de composant.Adds a type description provider for a component class.

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

Ajoute un fournisseur de description de type pour une instance unique d’un composant.Adds a type description provider for a single instance of a component.

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

Ajoute un fournisseur de description de type pour une classe de composant.Adds a type description provider for a component class.

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

Crée une association de type principal-secondaire entre deux objets.Creates a primary-secondary association between two objects.

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

Crée une instance du concepteur associé au composant spécifié et du type de concepteur spécifié.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[])

Crée un descripteur d’événement identique à un descripteur d’événement existant, quand le EventDescriptor existant est passé.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[])

Crée un nouveau descripteur d’événement qui est identique à un descripteur d’événement existant, en générant des informations de descripteur de façon dynamique à partir d’un événement spécifié sur un type.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[])

Crée un objet qui peut remplacer un autre type de données.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[])

Crée un descripteur de propriété à partir d’un descripteur de propriété existant, à l’aide du PropertyDescriptor et du tableau d’attributs existants spécifiés.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[])

Crée et lie dynamiquement un descripteur de propriété à un type, en utilisant le nom, le type et le tableau d’attributs de la propriété spécifiée.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)

Détermine si l'objet spécifié est identique à l'objet actuel.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)

Retourne une instance du type associée à l'objet principal spécifié.Returns an instance of the type associated with the specified primary object.

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

Retourne la collection d'attributs pour le composant spécifié.Returns the collection of attributes for the specified component.

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

Retourne une collection d'attributs pour le composant spécifié et une valeur booléenne indiquant qu'un descripteur de type personnalisé a été créé.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)

Retourne une collection d'attributs pour le type spécifié de composant.Returns a collection of attributes for the specified type of component.

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

Retourne le nom de la classe pour le composant spécifié à l'aide du descripteur de type par défaut.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)

Retourne le nom de la classe pour le composant spécifié à l'aide d'un descripteur de type personnalisé.Returns the name of the class for the specified component using a custom type descriptor.

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

Retourne le nom de la classe pour le type spécifié.Returns the name of the class for the specified type.

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

Retourne le nom du composant spécifié à l'aide du descripteur de type par défaut.Returns the name of the specified component using the default type descriptor.

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

Retourne le nom du composant spécifié, à l'aide d'un descripteur de type personnalisé.Returns the name of the specified component using a custom type descriptor.

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

Retourne un convertisseur de type pour le type du composant spécifié.Returns a type converter for the type of the specified component.

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

Retourne un convertisseur de type pour le type du composant spécifié avec un descripteur de type personnalisé.Returns a type converter for the type of the specified component with a custom type descriptor.

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

Retourne un convertisseur de type pour le type spécifié.Returns a type converter for the specified type.

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

Retourne l'événement par défaut pour le composant spécifié.Returns the default event for the specified component.

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

Retourne l'événement par défaut pour un composant avec un descripteur de type personnalisé.Returns the default event for a component with a custom type descriptor.

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

Retourne l'événement par défaut pour le type de composant spécifié.Returns the default event for the specified type of component.

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

Retourne la propriété par défaut pour le composant spécifié.Returns the default property for the specified component.

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

Retourne la propriété par défaut pour le composant spécifié avec un descripteur de type personnalisé.Returns the default property for the specified component with a custom type descriptor.

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

Retourne la propriété par défaut pour le type de composant spécifié.Returns the default property for the specified type of component.

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

Obtient un éditeur du type de base spécifié pour le composant spécifié.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)

Retourne un éditeur du type de base spécifié et possédant un descripteur de type personnalisé pour le composant spécifié.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)

Retourne un éditeur du type de base spécifié pour le type spécifié.Returns an editor with the specified base type for the specified type.

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

Retourne la collection d'événements pour le composant spécifié.Returns the collection of events for the specified component.

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

Retourne la collection d'événements pour un composant déterminé en utilisant comme filtre un tableau d'attributs spécifié.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)

Retourne la collection d'événements pour un composant spécifié en utilisant comme filtre un tableau d'attributs déterminé et un descripteur de type personnalisé.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)

Retourne la collection d'événements pour un composant spécifié avec un descripteur de type personnalisé.Returns the collection of events for a specified component with a custom type descriptor.

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

Retourne la collection d'événements pour un type de composant spécifié.Returns the collection of events for a specified type of component.

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

Retourne la collection d'événements pour un type de composant déterminé en utilisant comme filtre un tableau d'attributs spécifié.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)

Retourne le nom qualifié complet du composant.Returns the fully qualified name of the component.

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

Fait office de fonction de hachage par défaut.Serves as the default hash function.

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

Retourne la collection de propriétés pour un composant spécifié.Returns the collection of properties for a specified component.

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

Retourne la collection de propriétés pour un composant déterminé en utilisant comme filtre un tableau d'attributs spécifié.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)

Retourne la collection des propriétés pour un composant spécifié en utilisant comme filtre un tableau d'attributs déterminé et un descripteur de type personnalisé.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)

Retourne la collection de propriétés pour un composant spécifié, à l'aide du descripteur de type par défaut.Returns the collection of properties for a specified component using the default type descriptor.

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

Retourne la collection de propriétés pour un type de composant spécifié.Returns the collection of properties for a specified type of component.

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

Retourne la collection de propriétés pour un type de composant déterminé en utilisant comme filtre un tableau d'attributs spécifié.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)

Retourne le fournisseur de description de type pour le composant spécifié.Returns the type description provider for the specified component.

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

Retourne le fournisseur de description de type pour le type spécifié.Returns the type description provider for the specified type.

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

Retourne Type qui peut être utilisé pour effectuer la réflexion en fonction d'un objet.Returns a Type that can be used to perform reflection, given an object.

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

Retourne Type qui peut être utilisé pour effectuer la réflexion en fonction d'un type de classe.Returns a Type that can be used to perform reflection, given a class type.

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

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

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

Crée une copie superficielle de l'objet Object actuel.Creates a shallow copy of the current Object.

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

Efface du cache les propriétés et événements de l'assembly spécifié.Clears the properties and events for the specified assembly from the cache.

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

Efface du cache les propriétés et événements pour le module spécifié.Clears the properties and events for the specified module from the cache.

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

Efface du cache les propriétés et événements pour le composant spécifié.Clears the properties and events for the specified component from the cache.

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

Efface du cache les propriétés et événements pour le type de composant spécifié.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)

Supprime une association entre deux objets.Removes an association between two objects.

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

Supprime toutes les associations pour un objet principal.Removes all associations for a primary object.

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

Supprime un fournisseur de description de type ajouté précédemment et associé à l'objet spécifié.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)

Supprime un fournisseur de description de type ajouté précédemment et associé au type spécifié.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)

Supprime un fournisseur de description de type ajouté précédemment et associé à l'objet spécifié.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)

Supprime un fournisseur de description de type ajouté précédemment et associé au type spécifié.Removes a previously added type description provider that is associated with the specified type.

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

Trie des descripteurs selon leur nom.Sorts descriptors using the name of the descriptor.

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

Retourne une chaîne qui représente l'objet actuel.Returns a string that represents the current object.

(Inherited from Object)

Événements

Refreshed Refreshed Refreshed Refreshed

Se produit lorsque le cache d'un composant est effacé.Occurs when the cache for a component is cleared.

S’applique à

Voir aussi