TypeDescriptor.AddProvider Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Adiciona um fornecedor de descrição de tipo à lista de fornecedores para este tipo de descritor.
Sobrecargas
| Name | Description |
|---|---|
| AddProvider(TypeDescriptionProvider, Object) |
Adiciona um fornecedor de descrição de tipo para uma única instância de um componente. |
| AddProvider(TypeDescriptionProvider, Type) |
Adiciona um fornecedor de descrição de tipos para uma classe de componente. |
AddProvider(TypeDescriptionProvider, Object)
Adiciona um fornecedor 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 acrescentar.
- instance
- Object
Uma instância do componente alvo.
Exceções
Um ou ambos os parâmetros são null.
Observações
O AddProvider(TypeDescriptionProvider, Object) método adiciona um fornecedor de descrição de tipos que fornece informação de tipo para uma única instância de um componente. Se um fornecedor for adicionado por este método, o método do CreateInstance fornecedor não será chamado porque a instância já existe.
Este método não mantém uma referência rígida ao componente, pelo que não impede que o componente seja finalizado.
É possível adicionar múltiplos fornecedores de descrição de tipos para o mesmo tipo ou objeto. Se isto ocorrer, o primeiro fornecedor de descrição de tipos encontrado que forneça informação de tipo será usado exclusivamente. Como os fornecedores de informação de tipo são armazenados numa pilha, o último fornecedor adicionado será o primeiro a ser consultado. Este comportamento permite que os AddProvider(TypeDescriptionProvider, Object) métodos e RemoveProvider sejam usados para empurrar e estourar fornecedores de descrição de tipos, conforme necessário para cenários específicos.
Se for bem-sucedido, este método chama o Refresh(Object) método no instance parâmetro.
Note
As duas versões deste método produzem resultados com diferentes âmbitos. O AddProvider método que utiliza um Object parâmetro afeta apenas essa única instância do componente especificado. Em contraste, a outra sobrecarga, que ocupa um Type parâmetro, afeta todas as instâncias do componente descrito por esse tipo.
Usa o AddProviderTransparent(TypeDescriptionProvider, Object) método se precisares de ligar a partir de código parcialmente confiável.
Ver também
Aplica-se a
AddProvider(TypeDescriptionProvider, Type)
Adiciona um fornecedor de descrição de tipos para 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 acrescentar.
Exceções
Um ou ambos os parâmetros são null.
Observações
O AddProvider(TypeDescriptionProvider, Type) método adiciona um fornecedor de descrição de tipos que fornece informação de tipo para a classe especificada, classes derivadas e todas as instâncias destes tipos.
Note
O type parâmetro pode ser de qualquer tipo, incluindo uma interface. Por exemplo, para fornecer informação personalizada de tipos e instâncias para todos os componentes, especificaria typeof(IComponent). A passagem typeof(object) irá ligar para o prestador para fornecer informações de tipo para todos os tipos.
Este método não mantém uma referência rígida a nenhum objeto, pelo que não impede que os objetos sejam finalizados.
É possível adicionar múltiplos fornecedores de descrição de tipos para o mesmo tipo ou objeto. Se isto ocorrer, o primeiro fornecedor de descrição de tipos encontrado que forneça informação de tipo será usado exclusivamente. Como os fornecedores de informação de tipos são armazenados numa pilha, o último fornecedor adicionado será o primeiro a ser consultado. Este comportamento permite que os AddProvider(TypeDescriptionProvider, Type) métodos e RemoveProvider sejam usados para empurrar e estourar fornecedores de descrição de tipos, conforme necessário para cenários específicos.
Se for bem-sucedido, este método chama o Refresh(Type) método no type parâmetro.
Note
As duas versões deste método produzem resultados com diferentes âmbitos. O AddProvider método que utiliza um Object parâmetro afeta apenas essa única instância do componente especificado. Em contraste, a outra sobrecarga, que ocupa um Type parâmetro, afeta todas as instâncias do componente descrito por esse tipo.
Usa o AddProviderTransparent(TypeDescriptionProvider, Type) método se precisares de ligar a partir de código parcialmente confiável.