TypeDescriptor Classe

Définition

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
TypeDescriptor

Remarques

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

En revanche, TypeDescriptor est un mécanisme d’inspection extensible pour les composants : les classes qui implémentent l' IComponent interface. Contrairement à la réflexion, elle n’examine pas les méthodes. TypeDescriptor peut être étendu de manière dynamique par plusieurs services disponibles via le du 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 de manière complète et dynamique 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 d’être différente de sa représentation réelle au moment de l’exécution, ce qui rend TypeDescriptor utile la génération de l’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 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. É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.

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. Utilisez la méthode qui appelle pour 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, elles sont constantes pendant la durée de vie d’un objet. Toutefois, les fournisseurs d’extendeurs et les concepteurs peuvent modifier le jeu de propriétés sur 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 à

Voir aussi