Ler em inglês

Compartilhar via


ToolboxService.GetToolboxItems Método

Definição

Retorna um ICollection de objetos ToolboxItem.

Sobrecargas

GetToolboxItems(Assembly, String, Boolean)

Retorna um ICollection de ToolboxItem objetos para o assembly determinado.

GetToolboxItems(AssemblyName, Boolean)

Retorna um ICollection de ToolboxItem objetos para o assembly determinado.

GetToolboxItems(AssemblyName)

Retorna um ICollection de ToolboxItem objetos para o assembly determinado.

GetToolboxItems(Assembly, String)

Retorna um ICollection que contém todos os itens da caixa de ferramentas no assembly fornecido.

GetToolboxItems(Assembly, String, Boolean)

Retorna um ICollection de ToolboxItem objetos para o assembly determinado.

public static System.Collections.ICollection GetToolboxItems (System.Reflection.Assembly a, string newCodeBase, bool throwOnError);

Parâmetros

a
Assembly

O assembly a ser enumerado.

newCodeBase
String

Uma cadeia de caracteres que é o local da URL do assembly.

throwOnError
Boolean

true para lançar uma exceção no erro, caso contrário, false.

Retornos

Uma coleção que contém todos os itens da caixa de ferramentas no assembly representado pelo nome do assembly determinado.

Exceções

Comentários

O GetToolboxItems método examina o assembly para todos os tipos que dão suporte a itens de caixa de ferramentas e retorna itens para esses tipos. Para dar suporte a um item de caixa de ferramentas, um tipo deve ter as seguintes características:

  • Seja público.

  • Implementar IComponent.

  • Não seja abstrato.

  • Não tem um ToolboxItemAttribute definido como false em seu tipo.

  • Não contém parâmetros genéricos.

Os assemblies são bloqueados durante um processo, portanto, enumerar vários arquivos por meio GetToolboxItems pode fazer com que muitos assemblies sejam carregados. Os GetToolboxItems métodos que levam um nome de assembly criam um separado AppDomain para pesquisar assemblies. Quando terminar de enumerar ToolboxItem objetos para um conjunto de assemblies, você poderá chamar o UnloadToolboxItems método , que descarrega e AppDomain libera as referências de arquivo nos assemblies carregados.

Aplica-se a

GetToolboxItems(AssemblyName, Boolean)

Retorna um ICollection de ToolboxItem objetos para o assembly determinado.

public static System.Collections.ICollection GetToolboxItems (System.Reflection.AssemblyName an, bool throwOnError);

Parâmetros

an
AssemblyName

Um nome de assembly do qual carregar um assembly.

throwOnError
Boolean

true para lançar uma exceção no erro, caso contrário, false.

Retornos

Uma coleção que contém todos os itens da caixa de ferramentas no assembly representado pelo nome do assembly determinado.

Exceções

an é null.

Comentários

O GetToolboxItems método examina o assembly para todos os tipos que dão suporte a itens de caixa de ferramentas e retorna itens para esses tipos. Para dar suporte a um item de caixa de ferramentas, um tipo deve ter as seguintes características:

  • Seja público.

  • Implementar IComponent.

  • Não seja abstrato.

  • Não tem um ToolboxItemAttribute definido como false em seu tipo.

  • Não contém parâmetros genéricos.

Os assemblies são bloqueados durante um processo, portanto, enumerar vários arquivos por meio GetToolboxItems pode fazer com que muitos assemblies sejam carregados. Os GetToolboxItems métodos que levam um nome de assembly criam um separado AppDomain para pesquisar assemblies. Quando terminar de enumerar ToolboxItem objetos para um conjunto de assemblies, você poderá chamar o UnloadToolboxItems método , que descarrega e AppDomain libera as referências de arquivo nos assemblies carregados.

Aplica-se a

GetToolboxItems(AssemblyName)

Retorna um ICollection de ToolboxItem objetos para o assembly determinado.

public static System.Collections.ICollection GetToolboxItems (System.Reflection.AssemblyName an);

Parâmetros

an
AssemblyName

Um nome de assembly do qual carregar um assembly.

Retornos

Uma coleção que contém todos os itens da caixa de ferramentas no assembly representado pelo nome do assembly determinado.

Exceções

an é null.

Comentários

O GetToolboxItems método examina o assembly para todos os tipos que dão suporte a itens de caixa de ferramentas e retorna itens para esses tipos. Para dar suporte a um item de caixa de ferramentas, um tipo deve ter as seguintes características:

  • Seja público.

  • Implementar IComponent.

  • Não seja abstrato.

  • Não tem um ToolboxItemAttribute definido como false em seu tipo.

  • Não contém parâmetros genéricos.

Os assemblies são bloqueados durante um processo, portanto, enumerar vários arquivos por meio GetToolboxItems pode fazer com que muitos assemblies sejam carregados. Os GetToolboxItems métodos que levam um nome de assembly criam um separado AppDomain para pesquisar assemblies. Quando terminar de enumerar ToolboxItem objetos para um conjunto de assemblies, você poderá chamar o UnloadToolboxItems método , que descarrega e AppDomain libera as referências de arquivo nos assemblies carregados.

Assemblies carregados dessa maneira são carregados em um separado AppDomain para que possam ser descarregados posteriormente. Isso apenas bloqueia momentaneamente o arquivo de assembly.

Confira também

Aplica-se a

GetToolboxItems(Assembly, String)

Retorna um ICollection que contém todos os itens da caixa de ferramentas no assembly fornecido.

public static System.Collections.ICollection GetToolboxItems (System.Reflection.Assembly a, string newCodeBase);

Parâmetros

a
Assembly

O assembly a ser enumerado.

newCodeBase
String

Uma cadeia de caracteres que é o local da URL do assembly.

Retornos

Uma coleção que contém todos os itens da caixa de ferramentas no assembly especificado.

Exceções

Comentários

O GetToolboxItems método examina o assembly para todos os tipos que dão suporte a itens de caixa de ferramentas e retorna itens para esses tipos. Para dar suporte a um item de caixa de ferramentas, um tipo deve ter as seguintes características:

  • Seja público.

  • Implementar IComponent.

  • Não seja abstrato.

  • Não tem um ToolboxItemAttribute definido como false em seu tipo.

  • Não contém parâmetros genéricos.

Os assemblies são bloqueados durante um processo, portanto, enumerar vários arquivos por meio GetToolboxItems pode fazer com que muitos assemblies sejam carregados. Os GetToolboxItems métodos que levam um nome de assembly criam um separado AppDomain para pesquisar assemblies. Quando terminar de enumerar ToolboxItem objetos para um conjunto de assemblies, você poderá chamar o UnloadToolboxItems método , que descarrega e AppDomain libera as referências de arquivo nos assemblies carregados.

Confira também

Aplica-se a