TypeDescriptor Classe

Définition

Espace de noms:

System.ComponentModel

Assembly:

System.ComponentModel.TypeConverter.dll

Source:

TypeDescriptor.cs

Fournit des informations sur les caractéristiques d’un composant, telles que ses attributs, ses propriétés et ses événements. Cette classe ne peut pas être héritée.

public ref class TypeDescriptor sealed

public sealed class TypeDescriptor

type TypeDescriptor = class

Public NotInheritable Class TypeDescriptor

Héritage

Object

TypeDescriptor

Remarques

Le .NET Framework fournit deux façons d’accéder aux métadonnées sur un type : l’API de réflexion fournie dans l’espace de noms System.Reflection et la classe TypeDescriptor. La réflexion est un mécanisme général disponible pour tous les types, car sa base est établie dans la méthode GetType de la classe Object racine. 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. Pour plus d’informations, consultez les rubriques de réflexion.

En revanche, TypeDescriptor est un mécanisme d’inspection extensible pour les composants : ces classes qui implémentent l’interface IComponent. Contrairement à la réflexion, elle n’inspecte pas les méthodes. TypeDescriptor pouvez être étendu dynamiquement par plusieurs services disponibles via le Sitedu composant cible. Le tableau suivant présente ces services.

Nom du service	Description
IExtenderProvider	Active une autre classe, telle que ToolTip, pour fournir des propriétés supplémentaires à un composant.
ITypeDescriptorFilterService	Permet à un autre objet de modifier les métadonnées standard exposées par un composant.
ICustomTypeDescriptor	Permet à une classe de spécifier complètement et dynamiquement ses propres métadonnées, en remplaçant le mécanisme d’inspection standard de TypeDescriptor.

L’extensibilité fournie par TypeDescriptor permet à la représentation au moment du design d’un composant de différer de sa représentation réelle au moment de l’exécution, ce qui rend TypeDescriptor utile pour la création d’une infrastructure au moment de la conception.

Toutes les méthodes de TypeDescriptor sont static. Vous ne pouvez pas créer une instance de cette classe et cette classe ne peut pas être héritée.

Vous pouvez définir des valeurs de propriété et d’événement de deux façons différentes : les spécifier dans la classe de composant ou les modifier au moment du design. Étant donné que vous pouvez définir ces valeurs de deux façons, les méthodes surchargées de TypeDescriptor prennent deux types de paramètres différents : un type de classe ou une instance d’objet.

Lorsque vous souhaitez accéder à TypeDescriptor informations et que vous disposez d’une instance de l’objet, utilisez la méthode qui appelle un composant. Utilisez la méthode qui appelle le type de classe uniquement lorsque vous n’avez pas d’instance de l’objet.

Les propriétés et les événements sont mis en cache par TypeDescriptor pour la vitesse. En règle générale, ils sont constants pour la durée de vie d’un objet. Toutefois, les fournisseurs d’extendeur et les concepteurs peuvent modifier l’ensemble des propriétés sur un objet. Si c’est le cas, la méthode Refresh doit être appelée pour mettre à jour le cache.

Propriétés

ComNativeDescriptorHandler	Obsolète. Obtient ou définit le fournisseur pour les informations de type COM (Component Object Model) pour le composant cible.
ComObjectType	Obtient le type de l’objet COM (Component Object Model) représenté par le composant cible.
InterfaceType	Obtient un type qui représente un fournisseur de description de type pour tous les types d’interface.

Méthodes

AddAttributes(Object, Attribute[])	Ajoute des attributs de niveau classe à l’instance de composant cible.
AddAttributes(Type, Attribute[])	Ajoute des attributs de niveau classe au type de composant cible.
AddEditorTable(Type, Hashtable)	Ajoute une table d’éditeur pour le type de base de l’éditeur donné.
AddProvider(TypeDescriptionProvider, Object)	Ajoute un fournisseur de description de type pour une seule instance d’un composant.
AddProvider(TypeDescriptionProvider, Type)	Ajoute un fournisseur de description de type pour une classe de composant.
AddProviderTransparent(TypeDescriptionProvider, Object)	Ajoute un fournisseur de description de type pour une seule instance d’un composant.
AddProviderTransparent(TypeDescriptionProvider, Type)	Ajoute un fournisseur de description de type pour une classe de composant.
CreateAssociation(Object, Object)	Crée une association primaire secondaire entre deux objets.
CreateDesigner(IComponent, Type)	Crée une instance du concepteur associé au composant spécifié et du type de concepteur spécifié.
CreateEvent(Type, EventDescriptor, Attribute[])	Crée un descripteur d’événement identique à un descripteur d’événement existant, lorsqu’il a passé le EventDescriptorexistant.
CreateEvent(Type, String, Type, Attribute[])	Crée un descripteur d’événement identique à un descripteur d’événement existant en générant dynamiquement des informations de descripteur à partir d’un événement spécifié sur un type.
CreateInstance(IServiceProvider, Type, Type[], Object[])	Crée un objet qui peut remplacer un autre type de données.
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 spécifiés.
CreateProperty(Type, String, Type, Attribute[])	Crée et lie dynamiquement un descripteur de propriété à un type à l’aide du nom de propriété, du type et du tableau d’attributs spécifiés.
Equals(Object)	Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object)
GetAssociation(Type, Object)	Retourne une instance du type associé à l’objet principal spécifié.
GetAttributes(Object)	Retourne la collection d’attributs pour le composant spécifié.
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éé.
GetAttributes(Type)	Retourne une collection d’attributs pour le type de composant spécifié.
GetClassName(Object)	Retourne le nom de la classe pour le composant spécifié à l’aide du descripteur de type par défaut.
GetClassName(Object, Boolean)	Retourne le nom de la classe pour le composant spécifié à l’aide d’un descripteur de type personnalisé.
GetClassName(Type)	Retourne le nom de la classe pour le type spécifié.
GetComponentName(Object)	Retourne le nom du composant spécifié à l’aide du descripteur de type par défaut.
GetComponentName(Object, Boolean)	Retourne le nom du composant spécifié à l’aide d’un descripteur de type personnalisé.
GetConverter(Object)	Retourne un convertisseur de type pour le type du composant spécifié.
GetConverter(Object, Boolean)	Retourne un convertisseur de type pour le type du composant spécifié avec un descripteur de type personnalisé.
GetConverter(Type)	Retourne un convertisseur de type pour le type spécifié.
GetDefaultEvent(Object)	Retourne l’événement par défaut pour le composant spécifié.
GetDefaultEvent(Object, Boolean)	Retourne l’événement par défaut d’un composant avec un descripteur de type personnalisé.
GetDefaultEvent(Type)	Retourne l’événement par défaut pour le type de composant spécifié.
GetDefaultProperty(Object)	Retourne la propriété par défaut du composant spécifié.
GetDefaultProperty(Object, Boolean)	Retourne la propriété par défaut du composant spécifié avec un descripteur de type personnalisé.
GetDefaultProperty(Type)	Retourne la propriété par défaut pour le type de composant spécifié.
GetEditor(Object, Type)	Obtient un éditeur avec le type de base spécifié pour le composant spécifié.
GetEditor(Object, Type, Boolean)	Retourne un éditeur avec le type de base spécifié et avec un descripteur de type personnalisé pour le composant spécifié.
GetEditor(Type, Type)	Retourne un éditeur avec le type de base spécifié pour le type spécifié.
GetEvents(Object)	Retourne la collection d’événements pour le composant spécifié.
GetEvents(Object, Attribute[])	Retourne la collection d’événements d’un composant spécifié à l’aide d’un tableau d’attributs spécifié en tant que filtre.
GetEvents(Object, Attribute[], Boolean)	Retourne la collection d’événements d’un composant spécifié à l’aide d’un tableau d’attributs spécifié en tant que filtre et à l’aide d’un descripteur de type personnalisé.
GetEvents(Object, Boolean)	Retourne la collection d’événements pour un composant spécifié avec un descripteur de type personnalisé.
GetEvents(Type)	Retourne la collection d’événements pour un type de composant spécifié.
GetEvents(Type, Attribute[])	Retourne la collection d’événements pour un type de composant spécifié à l’aide d’un tableau d’attributs spécifié en tant que filtre.
GetFullComponentName(Object)	Retourne le nom complet du composant.
GetHashCode()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetProperties(Object)	Retourne la collection de propriétés d’un composant spécifié.
GetProperties(Object, Attribute[])	Retourne la collection de propriétés d’un composant spécifié à l’aide d’un tableau d’attributs spécifié en tant que filtre.
GetProperties(Object, Attribute[], Boolean)	Retourne la collection de propriétés d’un composant spécifié à l’aide d’un tableau d’attributs spécifié en tant que filtre et à l’aide d’un descripteur de type personnalisé.
GetProperties(Object, Boolean)	Retourne la collection de propriétés d’un composant spécifié à l’aide du descripteur de type par défaut.
GetProperties(Type)	Retourne la collection de propriétés d’un type de composant spécifié.
GetProperties(Type, Attribute[])	Retourne la collection de propriétés d’un type de composant spécifié à l’aide d’un tableau d’attributs spécifié en tant que filtre.
GetProvider(Object)	Retourne le fournisseur de description de type pour le composant spécifié.
GetProvider(Type)	Retourne le fournisseur de description de type pour le type spécifié.
GetReflectionType(Object)	Retourne une Type qui peut être utilisée pour effectuer la réflexion, en fonction d’un objet.
GetReflectionType(Type)	Retourne une Type qui peut être utilisée pour effectuer une réflexion, en fonction d’un type de classe.
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
Refresh(Assembly)	Efface les propriétés et les événements de l’assembly spécifié à partir du cache.
Refresh(Module)	Efface les propriétés et les événements du module spécifié à partir du cache.
Refresh(Object)	Efface les propriétés et les événements du composant spécifié du cache.
Refresh(Type)	Efface les propriétés et les événements du type de composant spécifié du cache.
RemoveAssociation(Object, Object)	Supprime une association entre deux objets.
RemoveAssociations(Object)	Supprime toutes les associations d’un objet principal.
RemoveProvider(TypeDescriptionProvider, Object)	Supprime un fournisseur de description de type précédemment ajouté associé à l’objet spécifié.
RemoveProvider(TypeDescriptionProvider, Type)	Supprime un fournisseur de description de type précédemment ajouté associé au type spécifié.
RemoveProviderTransparent(TypeDescriptionProvider, Object)	Supprime un fournisseur de description de type précédemment ajouté associé à l’objet spécifié.
RemoveProviderTransparent(TypeDescriptionProvider, Type)	Supprime un fournisseur de description de type précédemment ajouté associé au type spécifié.
SortDescriptorArray(IList)	Trie les descripteurs à l’aide du nom du descripteur.
ToString()	Retourne une chaîne qui représente l’objet actuel. (Hérité de Object)

Événements

Refreshed

Se produit lorsque le cache d’un composant est effacé.

Voir aussi

• EventDescriptor
• PropertyDescriptor
• System.Reflection
• IComponent
• ISite
• Vue d’ensemble du descripteur de type
• de réflexion