TypeDescriptor.AddProvider Méthode
Définition
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.
Ajoute un fournisseur de description de type à la liste des fournisseurs pour ce descripteur de type.
Surcharges
| Nom | Description |
|---|---|
| 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. |
AddProvider(TypeDescriptionProvider, Object)
Ajoute un fournisseur de description de type pour une seule instance d’un composant.
public:
static void AddProvider(System::ComponentModel::TypeDescriptionProvider ^ provider, System::Object ^ instance);public static void AddProvider(System.ComponentModel.TypeDescriptionProvider provider, object instance);static member AddProvider : System.ComponentModel.TypeDescriptionProvider * obj -> unitPublic Shared Sub AddProvider (provider As TypeDescriptionProvider, instance As Object)Paramètres
- provider
- TypeDescriptionProvider
À TypeDescriptionProvider ajouter.
- instance
- Object
Instance du composant cible.
Exceptions
Un ou les deux paramètres sont null.
Remarques
La AddProvider(TypeDescriptionProvider, Object) méthode ajoute un fournisseur de description de type qui fournit des informations de type pour une instance unique d’un composant. Si un fournisseur est ajouté par cette méthode, la méthode du CreateInstance fournisseur ne sera pas appelée, car l’instance existe déjà.
Cette méthode ne conserve pas de référence dure au composant. Elle n’empêche donc pas la finalisation du composant.
Il est possible d’ajouter plusieurs fournisseurs de description de type pour le même type ou objet. Si cela se produit, le premier fournisseur de description de type rencontré qui fournit des informations de type sera utilisé exclusivement. Étant donné que les fournisseurs d’informations de type sont stockés dans une pile, le dernier fournisseur ajouté sera le premier interrogé. Ce comportement permet aux fournisseurs de description de type push et pop d’utiliser les AddProvider(TypeDescriptionProvider, Object) méthodes et RemoveProvider les méthodes requises pour des scénarios particuliers.
Si elle réussit, cette méthode appelle la Refresh(Object) méthode sur le instance paramètre.
Note
Les deux versions de cette méthode produisent des résultats avec des étendues différentes. La AddProvider méthode qui prend un Object paramètre affecte uniquement cette seule instance du composant spécifié. En revanche, l’autre surcharge, qui prend un Type paramètre, affecte toutes les instances du composant décrits par ce type.
Utilisez la AddProviderTransparent(TypeDescriptionProvider, Object) méthode si vous devez appeler à partir d’un code partiellement approuvé.
Voir aussi
S’applique à
AddProvider(TypeDescriptionProvider, Type)
Ajoute un fournisseur de description de type pour une classe de composant.
public:
static void AddProvider(System::ComponentModel::TypeDescriptionProvider ^ provider, Type ^ type);public static void AddProvider(System.ComponentModel.TypeDescriptionProvider provider, Type type);static member AddProvider : System.ComponentModel.TypeDescriptionProvider * Type -> unitPublic Shared Sub AddProvider (provider As TypeDescriptionProvider, type As Type)Paramètres
- provider
- TypeDescriptionProvider
À TypeDescriptionProvider ajouter.
Exceptions
Un ou les deux paramètres sont null.
Remarques
La AddProvider(TypeDescriptionProvider, Type) méthode ajoute un fournisseur de description de type qui fournit des informations de type pour la classe spécifiée, les classes dérivées et toutes les instances de ces types.
Note
Le type paramètre peut être n’importe quel type, y compris une interface. Par exemple, pour fournir des informations de type et d’instance personnalisées pour tous les composants, vous devez spécifier typeof(IComponent). Le passage typeof(object) appelle le fournisseur pour fournir des informations de type pour tous les types.
Cette méthode ne conserve pas de référence difficile à n’importe quel objet, de sorte qu’elle n’empêche pas la finalisation des objets.
Il est possible d’ajouter plusieurs fournisseurs de description de type pour le même type ou objet. Si cela se produit, le premier fournisseur de description de type rencontré qui fournit des informations de type sera utilisé exclusivement. Étant donné que les fournisseurs d’informations de type sont stockés dans une pile, le dernier fournisseur ajouté sera le premier interrogé. Ce comportement permet aux fournisseurs de description de type push et pop d’utiliser les AddProvider(TypeDescriptionProvider, Type) méthodes et RemoveProvider les méthodes requises pour des scénarios particuliers.
Si elle réussit, cette méthode appelle la Refresh(Type) méthode sur le type paramètre.
Note
Les deux versions de cette méthode produisent des résultats avec des étendues différentes. La AddProvider méthode qui prend un Object paramètre affecte uniquement cette seule instance du composant spécifié. En revanche, l’autre surcharge, qui prend un Type paramètre, affecte toutes les instances du composant décrits par ce type.
Utilisez la AddProviderTransparent(TypeDescriptionProvider, Type) méthode si vous devez appeler à partir d’un code partiellement approuvé.