Compartilhar via

Assemblies de coleção para geração de tipos dinâmicos

  • Artigo

Assemblies de coleção são assemblies dinâmicos que podem ser descarregados sem descarregar o domínio do aplicativo no qual eles foram criados. Toda a memória gerenciada e não gerenciada usada por um assembly de coleção e os tipos que ele contém pode ser recuperada. Informações como o nome do assembly são removidas das tabelas internas.

Para habilitar o descarregamento, use o sinalizador AssemblyBuilderAccess.RunAndCollect ao criar um assembly dinâmico. O assembly é transitório (ou seja, ele não pode ser salvo) e está sujeito às limitações descritas na seção Restrições de assemblies de coleção. O CLR (Common Language Runtime) descarrega um assembly de coleção automaticamente quando todos os objetos associados ao assembly são liberados. Em todos os outros aspectos, os assemblies de coleção são criados e usados da mesma maneira de outros assemblies dinâmicos.

Tempo de vida dos assemblies de coleção

O tempo de vida de um assembly de coleção é controlado pela existência de referências aos tipos que ele contém e aos objetos que são criados com base nesses tipos. O Common Language Runtime não descarregará um assembly contanto que uma ou mais das seguintes condições exista (T é qualquer tipo definido no assembly):

  • Uma instância de T.

  • Uma instância de uma matriz de T.

  • Uma instância de um tipo genérico que tem T como um de seus argumentos de tipo. Isso inclui coleções genéricas de T, mesmo se a coleção estiver vazia.

  • Uma instância de Type ou TypeBuilder que representa T.

    Importante

    É necessário liberar todos os objetos que representam partes do assembly. O ModuleBuilder que define T mantém uma referência ao TypeBuilder e o objeto AssemblyBuilder mantém uma referência ao ModuleBuilder; portanto, as referências a esses objetos devem ser liberadas. Até mesmo a existência de um LocalBuilder ou um ILGenerator usado na construção de T impede o descarregamento.

  • Uma referência estática a T por outro tipo definido de forma dinâmica T1 que ainda pode ser acessado pelo código em execução. Por exemplo, T1 pode derivar de T ou T pode ser o tipo de um parâmetro em um método de T1.

  • Um ByRef a um campo estático que pertence a T.

  • Um RuntimeTypeHandle, RuntimeFieldHandle ou RuntimeMethodHandle que se refere a T ou a um componente de T.

  • Uma instância de qualquer objeto de reflexão que poderá ser usada indireta ou diretamente para acessar o objeto Type que representa T. Por exemplo, o objeto Type de T pode ser obtido de um tipo de matriz cujo tipo de elemento é T ou de um tipo genérico que tem T como um argumento de tipo.

  • Um método M na pilha de chamadas de qualquer thread, em que M é um método de T ou um método de nível de módulo definido no assembly.

  • Um representante de um método estático definido em um módulo do assembly.

Se houver um único item dessa lista para apenas um tipo ou um método no assembly, o runtime não poderá descarregar o assembly.

Observação

Na verdade, o runtime não descarrega o assembly até que os finalizadores tenham sido executados para todos os itens da lista.

Para fins de acompanhamento do tempo de vida, um tipo genérico construído, como List<int> (no C#) ou List(Of Integer) (no Visual Basic), que é criado e usado na geração de um assembly de coleção é considerado como tendo sido definido no assembly que contém a definição de tipo genérico ou em um assembly que contém a definição de um de seus argumentos de tipo. O assembly exato usado é um detalhe de implementação e está sujeito a alterações.

Restrições de assemblies de coleção

As seguintes restrições se aplicam a assemblies de coleção:

  • Referências estáticas

    Os tipos em um assembly dinâmico comum não podem ter referências estáticas a tipos definidos em um assembly de coleção. Por exemplo, se você definir um tipo comum herdado de um tipo em um assembly de coleção, uma exceção NotSupportedException será gerada. Um tipo em um assembly de coleção pode ter referências estáticas a um tipo em outro assembly de coleção, mas isso aumenta o tempo de vida do assembly referenciado para o tempo de vida do assembly de referência.

As seguintes restrições se aplicam a assemblies de coleção no .NET Framework:

  • Interoperabilidade COM

    Nenhuma interface COM pode ser definida em um assembly de coleção e nenhuma instância de tipos em um assembly de coleção pode ser convertida em objetos COM. Um tipo em um assembly de coleção não pode servir como um CCW (COM Callable Wrapper) ou RCW (Runtime Callable Wrapper). No entanto, os tipos em assemblies de coleção podem usar objetos que implementam interfaces COM.

  • Invocação de plataforma

    Os métodos que têm o atributo DllImportAttribute não serão compilados quando forem declarados em um assembly de coleção. A instrução OpCodes.Calli não pode ser usada na implementação de um tipo em um assembly de coleção e esses tipos não podem ter marshalling para um código não gerenciado. No entanto, você pode chamar um código nativo por meio de um ponto de entrada declarado em um assembly que não seja de coleção.

  • Marshaling

    Objetos (em particular, representantes) que são definidos em assemblies de coleção não podem ter marshaling. Essa é uma restrição de todos os tipos emitidos transitórios.

  • Carregamento de assembly

    A emissão de reflexão é o único mecanismo com suporte para o carregamento de assemblies de coleção. Assemblies carregados por meio de qualquer outra forma de carregamento do assembly não podem ser descarregados.

  • Objetos associados ao contexto

    Não há suporte para variáveis de contexto estático. Tipos em um assembly de coleção não podem estender ContextBoundObject. No entanto, um código em assemblies de coleção podem usar objetos associados a contexto definidos em outro lugar.

  • Dados de thread estático

    Não há suporte para variáveis de thread estático.

As seguintes restrições se aplicam a assemblies de coleção no .NET Framework e nas versões .NET antes de .NET 9:

  • Campos estáticos com FixedAddressValueTypeAttribute

    Campos estáticos definidos em assemblies colecionáveis não podem ter o atributo FixedAddressValueTypeAttribute aplicado.

Confira também