TypeDescriptor.AddProvider Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Adiciona um provedor de descrição de tipo à lista de provedores deste descritor de tipo.
Sobrecargas
| AddProvider(TypeDescriptionProvider, Object) |
Adiciona um provedor de descrição de tipo para uma única instância de um componente. |
| AddProvider(TypeDescriptionProvider, Type) |
Adiciona um provedor de descrição de tipo de uma classe de componente. |
AddProvider(TypeDescriptionProvider, Object)
Adiciona um provedor de descrição de tipo para uma única instância de um componente.
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)Parâmetros
- provider
- TypeDescriptionProvider
O TypeDescriptionProvider a ser adicionado.
- instance
- Object
Uma instância do componente de destino.
Exceções
Um ou ambos os parâmetros são null.
Comentários
O AddProvider(TypeDescriptionProvider, Object) método adiciona um provedor de descrição de tipo que fornece informações de tipo para uma única instância de um componente. Se um provedor for adicionado por esse método, o método do CreateInstance provedor não será chamado porque a instância já existe.
Esse método não mantém uma referência dura ao componente, portanto, não impede que o componente seja finalizado.
É possível adicionar vários provedores de descrição de tipo para o mesmo tipo ou objeto. Se isso ocorrer, o primeiro provedor de descrição de tipo encontrado que fornece informações de tipo será usado exclusivamente. Como os provedores de informações de tipo são armazenados em uma pilha, o último provedor adicionado será o primeiro consultado. Esse comportamento permite que os métodos e RemoveProvider os AddProvider(TypeDescriptionProvider, Object) métodos sejam usados para enviar push e provedores de descrição de tipo pop conforme necessário para cenários específicos.
Se tiver êxito, esse método chamará o Refresh(Object) método no instance parâmetro.
Observação
As duas versões desse método produzem resultados com escopos diferentes. O AddProvider método que usa um Object parâmetro afeta apenas essa única instância do componente especificado. Por outro lado, a outra sobrecarga, que usa um Type parâmetro, afeta todas as instâncias do componente descritas por esse tipo.
Use o AddProviderTransparent(TypeDescriptionProvider, Object) método se precisar chamar de código parcialmente confiável.
Confira também
Aplica-se a
AddProvider(TypeDescriptionProvider, Type)
Adiciona um provedor de descrição de tipo de uma classe de componente.
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)Parâmetros
- provider
- TypeDescriptionProvider
O TypeDescriptionProvider a ser adicionado.
Exceções
Um ou ambos os parâmetros são null.
Comentários
O AddProvider(TypeDescriptionProvider, Type) método adiciona um provedor de descrição de tipo que fornece informações de tipo para a classe especificada, classes derivadas e todas as instâncias desses tipos.
Observação
O type parâmetro pode ser qualquer tipo, incluindo uma interface. Por exemplo, para fornecer informações personalizadas de tipo e instância para todos os componentes, você especificaria typeof(IComponent). Passar typeof(object) chamará o provedor para fornecer informações de tipo para todos os tipos.
Esse método não mantém uma referência dura a nenhum objeto, portanto, não impede que objetos sejam finalizados.
É possível adicionar vários provedores de descrição de tipo para o mesmo tipo ou objeto. Se isso ocorrer, o primeiro provedor de descrição de tipo encontrado que fornece informações de tipo será usado exclusivamente. Como os provedores de informações de tipo são armazenados em uma pilha, o último provedor adicionado será o primeiro consultado. Esse comportamento permite que os métodos e RemoveProvider os AddProvider(TypeDescriptionProvider, Type) métodos sejam usados para enviar push e provedores de descrição de tipo pop conforme necessário para cenários específicos.
Se tiver êxito, esse método chamará o Refresh(Type) método no type parâmetro.
Observação
As duas versões desse método produzem resultados com escopos diferentes. O AddProvider método que usa um Object parâmetro afeta apenas essa única instância do componente especificado. Por outro lado, a outra sobrecarga, que usa um Type parâmetro, afeta todas as instâncias do componente descritas por esse tipo.
Use o AddProviderTransparent(TypeDescriptionProvider, Type) método se precisar chamar de código parcialmente confiável.