TypeDescriptor Classe

Référence

Définition

Espace de noms:: System.ComponentModel

Assembly:: System.ComponentModel.TypeConverter.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Source:: TypeDescriptor.cs

Source:: TypeDescriptor.cs

Source:: TypeDescriptor.cs

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Fournit des informations relatives aux 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 offre deux façons d’accéder aux métadonnées sur un type : l’API de réflexion fournie dans l’espace System.Reflection de noms et la TypeDescriptor classe. La réflexion est un mécanisme général disponible pour tous les types, car sa base est établie dans la GetType méthode de la classe racine Object . Les informations qu’il retourne 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 : les classes qui implémentent l’interface IComponent . Contrairement à la réflexion, il n’inspecte pas les méthodes. TypeDescriptorpeut être étendu dynamiquement par plusieurs services disponibles via le composant cible.Site Le tableau suivant présente ces services.

Nom du service	Description
IExtenderProvider	Permet à une autre classe, telle que ToolTip, de 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 de la conception d’un composant de différer de sa représentation réelle au moment de l’exécution, ce qui est TypeDescriptor utile pour créer une infrastructure au moment du design.

Toutes les méthodes dans 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 les 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 de la conception. É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 aux 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 pendant la durée de vie d’un objet. Toutefois, les fournisseurs et concepteurs d’extension peuvent modifier l’ensemble des propriétés d’un objet. Si c’est le cas, la Refresh méthode doit être appelée pour mettre à jour le cache.

Propriétés

ComNativeDescriptorHandler	Obsolète. Obsolète. Obsolète. 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 du composant cible.
AddAttributes(Type, Attribute[])	Ajoute des attributs de classe au type du composant cible.
AddEditorTable(Type, Hashtable)	Ajoute une table d’éditeur pour le type de base d’éditeur donné.
AddProvider(TypeDescriptionProvider, Object)	Ajoute un fournisseur de description de type pour une instance unique 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 instance unique 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 de type principal-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, quand le EventDescriptor existant est passé.
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.
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 existants spécifiés.
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.
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é en utilisant le descripteur de type par défaut.
GetClassName(Object, Boolean)	Retourne le nom de la classe pour le composant spécifié en utilisant 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é en utilisant le descripteur de type par défaut.
GetComponentName(Object, Boolean)	Retourne le nom du composant spécifié en utilisant 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 du composant spécifié.
GetDefaultEvent(Object, Boolean)	Retourne l’événement par défaut pour un composant avec un descripteur de type personnalisé.
GetDefaultEvent(Type)	Retourne l’événement par défaut du 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 du 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é en utilisant comme filtre un tableau d’attributs spécifié.
GetEvents(Object, Attribute[], Boolean)	Retourne la collection d’événements d’un composant spécifié en utilisant comme filtre un tableau d’attributs spécifié, et en utilisant 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 d’un type spécifié de composant en utilisant comme filtre le tableau d’attributs spécifié.
GetFullComponentName(Object)	Retourne le nom complet du composant.
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetProperties(Object)	Retourne la collection de propriétés pour un composant spécifié.
GetProperties(Object, Attribute[])	Retourne la collection de propriétés d’un composant spécifié en utilisant comme filtre le tableau d’attributs spécifié.
GetProperties(Object, Attribute[], Boolean)	Retourne la collection de propriétés d’un composant spécifié en utilisant comme filtre un tableau d’attributs spécifié, et en utilisant un descripteur de type personnalisé.
GetProperties(Object, Boolean)	Retourne la collection de propriétés pour un composant spécifié en utilisant le descripteur de type par défaut.
GetProperties(Type)	Retourne la collection de propriétés pour un type de composant spécifié.
GetProperties(Type, Attribute[])	Retourne la collection de propriétés d’un type de composant spécifié en utilisant comme filtre le tableau d’attributs spécifié.
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 un Type qui peut être utilisé pour effectuer une réflexion sur un objet donné.
GetReflectionType(Type)	Retourne un Type qui peut être utilisé pour effectuer une réflexion, étant donné un type de classe.
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
Refresh(Assembly)	Efface du cache les propriétés et événements de l’assembly spécifié.
Refresh(Module)	Efface du cache les propriétés et événements du module spécifié.
Refresh(Object)	Efface du cache les propriétés et événements du composant spécifié.
Refresh(Type)	Efface du cache les propriétés et les événements du type de composant spécifié.
RemoveAssociation(Object, Object)	Supprime une association entre deux objets.
RemoveAssociations(Object)	Supprime toutes les associations pour un objet principal.
RemoveProvider(TypeDescriptionProvider, Object)	Supprime un fournisseur de description de type précédemment ajouté qui est associé à l’objet spécifié.
RemoveProvider(TypeDescriptionProvider, Type)	Supprime un fournisseur de description de type précédemment ajouté qui est associé au type spécifié.
RemoveProviderTransparent(TypeDescriptionProvider, Object)	Supprime un fournisseur de description de type précédemment ajouté qui est associé à l’objet spécifié.
RemoveProviderTransparent(TypeDescriptionProvider, Type)	Supprime un fournisseur de description de type précédemment ajouté qui est 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 quand le cache d’un composant est vidé.

S’applique à