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.
System.ComponentModel.TypeDescriptor
Espace de noms : System.ComponentModel
Assembly : System (dans System.dll)
<HostProtectionAttribute(SecurityAction.LinkDemand, SharedState := True)> _ Public NotInheritable Class TypeDescriptor
[HostProtectionAttribute(SecurityAction.LinkDemand, SharedState = true)] public sealed class TypeDescriptor
[HostProtectionAttribute(SecurityAction::LinkDemand, SharedState = true)] public ref class TypeDescriptor sealed
[<Sealed>] [<HostProtectionAttribute(SecurityAction.LinkDemand, SharedState = true)>] type TypeDescriptor = class end
Le type TypeDescriptor expose les membres suivants.
| Nom | Description | |
|---|---|---|
|
ComNativeDescriptorHandler | Infrastructure. Obsolète. Obtient ou définit le fournisseur pour les informations de type de Modèle COM pour le composant cible. |
|
|
ComObjectType | Obtient le type de l'objet Component Object Model (COM) 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. |
| Nom | Description | |
|---|---|---|
|
AddAttributes(Object, Attribute[]) | Ajoute des attributs de niveau classe à l'instance du composant cible. |
|
|
AddAttributes(Type, Attribute[]) | Ajoute des attributs de niveau classe au type de composant cible. |
|
|
AddEditorTable | 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 | Crée une association principale secondaire entre deux objets. |
|
|
CreateDesigner | Crée une instance du concepteur associé au composant spécifié et du type spécifié de concepteur. |
|
|
CreateEvent(Type, EventDescriptor, Attribute[]) | Crée un nouveau descripteur d'événement identique à un descripteur d'événement existant, une fois le EventDescriptor existant passé. |
|
|
CreateEvent(Type, String, Type, Attribute[]) | Crée un nouveau descripteur d'événement identique à un descripteur d'événement existant en générant de manière dynamique des informations sur le descripteur à partir d'un événement spécifié sur un type. |
|
|
CreateInstance | Crée un objet qui peut se substituer à un autre type de données. |
|
|
CreateProperty(Type, PropertyDescriptor, Attribute[]) | Crée un nouveau descripteur de propriété à partir d'un descripteur de propriété existant à l'aide du PropertyDescriptor existant 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'Object spécifié est égal à l'Object en cours. (Hérité de Object.) |
|
Finalize | Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de netto***ge avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.) |
|
|
GetAssociation | Retourne une instance du type associée à l'objet principal spécifié. |
|
|
GetAttributes(Object) | Retourne la collection d'attributs pour le composant spécifié. |
|
|
GetAttributes(Type) | Retourne une collection d'attributs pour le type spécifié de composant. |
|
|
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éé. |
|
|
GetClassName(Object) | Retourne le nom de la classe pour le composant spécifié à l'aide du descripteur de type par défaut. |
|
|
GetClassName(Type) | Retourne le nom de la classe pour le type spécifié. |
|
|
GetClassName(Object, Boolean) | Retourne le nom de la classe pour le composant spécifié à l'aide d'un descripteur de type personnalisé. |
|
|
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(Type) | Retourne un convertisseur de type pour le type spécifié. |
|
|
GetConverter(Object, Boolean) | Retourne un convertisseur de type pour le type du composant spécifié avec un descripteur de type personnalisé. |
|
|
GetDefaultEvent(Object) | Retourne l'événement par défaut pour le composant spécifié. |
|
|
GetDefaultEvent(Type) | Retourne l'événement par défaut pour le type de composant spécifié. |
|
|
GetDefaultEvent(Object, Boolean) | Retourne l'événement par défaut pour un composant avec un descripteur de type personnalisé. |
|
|
GetDefaultProperty(Object) | Retourne la propriété par défaut pour le composant spécifié. |
|
|
GetDefaultProperty(Type) | Retourne la propriété par défaut pour le type de composant spécifié. |
|
|
GetDefaultProperty(Object, Boolean) | Retourne la propriété par défaut pour le composant spécifié avec un descripteur de type personnalisé. |
|
|
GetEditor(Object, Type) | Obtient un éditeur du type de base spécifié pour le composant spécifié. |
|
|
GetEditor(Type, Type) | Retourne un éditeur du type de base spécifié pour le type spécifié. |
|
|
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é. |
|
|
GetEvents(Object) | Retourne la collection d'événements pour le composant spécifié. |
|
|
GetEvents(Type) | Retourne la collection d'événements pour un type de composant spécifié. |
|
|
GetEvents(Object, Attribute[]) | Retourne la collection d'événements pour un composant déterminé en utilisant comme filtre un tableau d'attributs spécifié. |
|
|
GetEvents(Object, Boolean) | Retourne la collection d'événements pour un composant spécifié avec un descripteur de type personnalisé. |
|
|
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é. |
|
|
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é. |
|
|
GetFullComponentName | Retourne le nom qualifié complet du composant. |
|
|
GetHashCode | Sert de fonction de hachage pour un type particulier. (Hérité de Object.) |
|
|
GetProperties(Object) | Retourne la collection de propriétés pour un composant spécifié. |
|
|
GetProperties(Type) | Retourne la collection de propriétés pour un type de composant spécifié. |
|
|
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é. |
|
|
GetProperties(Object, Boolean) | Retourne la collection de propriétés pour un composant spécifié, à l'aide du descripteur de type par défaut. |
|
|
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é. |
|
|
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é. |
|
|
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 Type qui peut être utilisé pour effectuer la réflexion en fonction d'un objet. |
|
|
GetReflectionType(Type) | Retourne Type qui peut être utilisé pour effectuer la réflexion en fonction d'un type de classe. |
|
|
GetType | Obtient le Type de l'instance actuelle. (Hérité de Object.) |
|
|
MemberwiseClone | Crée une copie superficielle de l'objet Object actif. (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 pour le module spécifié. |
|
|
Refresh(Object) | Efface du cache les propriétés et événements pour le composant spécifié. |
|
|
Refresh(Type) | Efface du cache les propriétés et événements pour le type de composant spécifié. |
|
|
RemoveAssociation | Supprime une association entre deux objets. |
|
|
RemoveAssociations | Supprime toutes les associations pour un objet principal. |
|
|
RemoveProvider(TypeDescriptionProvider, Object) | Supprime un fournisseur de description de type ajouté précédemment et associé à l'objet spécifié. |
|
|
RemoveProvider(TypeDescriptionProvider, Type) | Supprime un fournisseur de description de type ajouté précédemment et associé au type spécifié. |
|
|
RemoveProviderTransparent(TypeDescriptionProvider, Object) | Supprime un fournisseur de description de type ajouté précédemment et associé à l'objet spécifié. |
|
|
RemoveProviderTransparent(TypeDescriptionProvider, Type) | Supprime un fournisseur de description de type ajouté précédemment et associé au type spécifié. |
|
|
SortDescriptorArray | Trie des descripteurs selon leur nom. |
|
|
ToString | Retourne une chaîne qui représente l'objet actuel. (Hérité de Object.) |
| Nom | Description | |
|---|---|---|
|
Refreshed | Se produit lorsque le cache d'un composant est effacé. |
Le .NET Framework offre deux moyens 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 fondation est établie dans la méthode GetType de la classe Object racine. Les informations qu'elle retourne pour un type ne sont pas extensibles, au sens où elles ne peuvent pas être modifiées après la compilation du type cible. Pour plus d'informations, consultez les rubriques dans Réflexion.
En revanche, TypeDescriptor est un mécanisme d'inspection extensible pour les composants, à savoir les classes qui implémentent l'interface IComponent. Contrairement à Reflection, il n'inspecte pas les méthodes. TypeDescriptor peut être étendu dynamiquement par plusieurs services disponibles via le composant Site cible. Le tableau suivant indique ces services.
|
Nom du service |
Description |
|---|---|
|
Active une autre classe telle que ToolTip pour fournir des propriétés supplémentaires à un composant. |
|
|
Permet à un autre objet de modifier les métadonnées standard qui sont exposées par un composant. |
|
|
Active une classe afin de spécifier d'une manière complète et dynamique ses propres métadonnées et remplace 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 à l'exécution, ce qui rend TypeDescriptor utile pour construire 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és et d'événements de deux manières : en les spécifiant dans la classe du composant ou en les modifiant au moment du design. Comme 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.
Si vous souhaitez accéder à des informations sur TypeDescriptor et si vous disposez d'une instance de l'objet, utilisez la méthode qui appelle un composant. N'utilisez la méthode qui appelle le type de la classe que si vous ne possédez pas d'instance de l'objet.
Les propriétés et les événements sont mis en cache par TypeDescriptor pour améliorer la vitesse. Généralement, ils sont constants pendant toute la durée de vie d'un objet. Toutefois, les fournisseurs et les concepteurs d'extendeurs peuvent modifier le jeu de propriétés sur un objet. Si c'est le cas, la méthode Refresh doit être appelée pour mettre à jour le cache.
Remarque
|
|---|
|
L'attribut HostProtectionAttribute appliqué à ce type ou membre a la valeur de propriété Resources suivante : SharedState. HostProtectionAttribute n'affecte pas les applications bureautiques (qui sont généralement démarrées en double-cliquant sur une icône, en tapant une commande ou en entrant une URL dans un navigateur). Pour plus d'informations, consultez la classe HostProtectionAttribute ou Attributs de programmation et de protection des hôtes SQL Server. |
.NET Framework
Pris en charge dans : 4, 3.5, 3.0, 2.0, 1.1, 1.0.NET Framework Client Profile
Pris en charge dans : 4, 3.5 SP1Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2
Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.