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.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
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’espace de noms System.Reflection et la classe TypeDescriptor.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 établie dans la méthode GetType de la classe Object 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 implémentent l’interface IComponent.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. les TypeDescriptor peuvent être étendus dynamiquement par plusieurs services disponibles via le Sitedu composant 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, telle que ToolTip, 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 mécanisme d’inspection standard de TypeDescriptor.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 propre au moment de l’exécution, ce qui rend TypeDescriptor utile pour 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 de 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 informations de TypeDescriptor 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 en cache par TypeDescriptor 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 méthode Refresh 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

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

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

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[])

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

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)

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)

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)

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

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)

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

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)

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[])

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

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[])

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[])

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[])

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)

Détermine si l'objet spécifié est égal à l'objet actuel.Determines whether the specified object is equal to the current object.

(Hérité de Object)
GetAssociation(Type, Object)

Retourne une instance du type associé à l’objet principal spécifié.Returns an instance of the type associated with the specified primary 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)

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)

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

GetClassName(Object)

Retourne le nom de la classe pour le composant spécifié en utilisant le descripteur de type par défaut.Returns the name of the class for the specified component using the default type descriptor.

GetClassName(Object, Boolean)

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

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)

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

GetComponentName(Object, Boolean)

Retourne le nom du composant spécifié en utilisant un descripteur de type personnalisé.Returns the name of the specified component using a custom type descriptor.

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)

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)

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

GetDefaultEvent(Object)

Retourne l’événement par défaut du composant spécifié.Returns the default event for the specified component.

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)

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

GetDefaultProperty(Object)

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

GetDefaultProperty(Object, Boolean)

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

GetDefaultProperty(Type)

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

GetEditor(Object, Type)

Obtient un éditeur avec le 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)

Retourne un éditeur avec le type de base spécifié et avec 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)

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

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[])

Retourne la collection d’événements d’un composant spécifié 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)

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é.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)

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)

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[])

Retourne la collection d’événements d’un type spécifié de composant en utilisant comme filtre le 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)

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

GetHashCode()

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

(Hérité de 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[])

Retourne la collection de propriétés d’un composant spécifié en utilisant comme filtre le 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)

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é.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)

Retourne la collection de propriétés pour un composant spécifié en utilisant le descripteur de type par défaut.Returns the collection of properties for a specified component using the default type descriptor.

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[])

Retourne la collection de propriétés d’un type de composant spécifié en utilisant comme filtre le 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)

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

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)

Retourne un Type qui peut être utilisé pour effectuer une réflexion sur un objet donné.Returns a Type that can be used to perform reflection, given an object.

GetReflectionType(Type)

Retourne un Type qui peut être utilisé pour effectuer une réflexion, étant donné un type de classe.Returns a Type that can be used to perform reflection, given a class type.

GetType()

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

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
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)

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

Refresh(Object)

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

Refresh(Type)

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

RemoveAssociation(Object, Object)

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

RemoveAssociations(Object)

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

RemoveProvider(TypeDescriptionProvider, Object)

Supprime un fournisseur de description de type précédemment ajouté qui est associé à l’objet spécifié.Removes a previously added type description provider that is associated with the specified object.

RemoveProvider(TypeDescriptionProvider, Type)

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

RemoveProviderTransparent(TypeDescriptionProvider, Object)

Supprime un fournisseur de description de type précédemment ajouté qui est associé à l’objet spécifié.Removes a previously added type description provider that is associated with the specified object.

RemoveProviderTransparent(TypeDescriptionProvider, Type)

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

SortDescriptorArray(IList)

Trie les descripteurs à l’aide du nom du descripteur.Sorts descriptors using the name of the descriptor.

ToString()

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

(Hérité de Object)

Événements

Refreshed

Se produit quand le cache d’un composant est vidé.Occurs when the cache for a component is cleared.

S’applique à

Voir aussi