TypeDescriptor.AddProvider Método

Definição

Namespace:

System.ComponentModel

Assembly:

System.ComponentModel.TypeConverter.dll

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)

Origem:

TypeDescriptor.cs

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 -> unit

Public 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

ArgumentNullException

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 rígida 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 AddProvider(TypeDescriptionProvider, Object) métodos e RemoveProvider sejam usados para enviar provedores de descrição de tipo pop e push 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 do código parcialmente confiável.

Confira também

• RemoveProvider
• GetProvider(Object)
• CreateInstance(IServiceProvider, Type, Type[], Object[])

AddProvider(TypeDescriptionProvider, Type)

Origem:

TypeDescriptor.cs

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 -> unit

Public Shared Sub AddProvider (provider As TypeDescriptionProvider, type As Type)

Parâmetros

provider

TypeDescriptionProvider

O TypeDescriptionProvider a ser adicionado.

type

Type

O Type do componente de destino.

Exceções

ArgumentNullException

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 rígida 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 AddProvider(TypeDescriptionProvider, Type) métodos e RemoveProvider sejam usados para enviar provedores de descrição de tipo pop e push 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 do código parcialmente confiável.

Confira também

• GetProvider(Type)
• CreateInstance(IServiceProvider, Type, Type[], Object[])