Ensamblados recopilables para la generación dinámica de tipos
Los ensamblados recopilables son ensamblados dinámicos que se pueden descargar sin descargar el dominio de aplicación en el que se crearon. Se puede reclamar toda la memoria administrada y sin administrar usada por un ensamblado recopilable y los tipos que contiene. La información como el nombre de ensamblado se quita de las tablas internas.
Para habilitar la descarga, use la marca AssemblyBuilderAccess.RunAndCollect cuando cree un ensamblado dinámico. El ensamblado es transitorio (es decir, no se puede guardar) y está sujeto a las limitaciones descritas en la sección Restricciones de los ensamblados recopilables. Common Language Runtime (CLR) descarga automáticamente un ensamblado recopilable cuando se liberan todos los objetos asociados al ensamblado. En todos los demás aspectos, los ensamblados recopilables se crean y se usan de la misma manera que los demás ensamblados dinámicos.
Duración de los ensamblados recopilables
La duración de un ensamblado recopilable se controla mediante referencias a los tipos que contiene y los objetos que se crean a partir de esos tipos. Common Language Runtime no descarga un ensamblado siempre que existan uno o varios de los siguientes (T es cualquier tipo definido en el ensamblado):
Instancia de
T.Una instancia de una matriz de
T.Una instancia de un tipo genérico que tenga
Tcomo uno de sus argumentos de tipo. Esto incluye las recopilaciones genéricas deT, aun cuando esa recopilación esté vacía.Una instancia de Type o TypeBuilder que represente a
T.Importante
Debe liberar todos los objetos que representen a partes del ensamblado. El elemento ModuleBuilder que define
Tmantiene una referencia a TypeBuilder y el objeto AssemblyBuilder mantiene una referencia a ModuleBuilder, así que las referencias a estos objetos deben liberarse. Incluso la existencia de un elemento LocalBuilder o ILGenerator usado en la construcción deTevita la descarga.Una referencia estática a
Tpor parte de otro tipoT1definido de forma dinámica que siga siendo accesible mediante la ejecución de código. Por ejemplo,T1puede derivar deT, oTpuede ser el tipo de un parámetro en un método deT1.Un
ByRefcampo estático que pertenece aT.RuntimeTypeHandle, RuntimeFieldHandle o RuntimeMethodHandle que hace referencia a
To a un componente deT.Una instancia de cualquier objeto de reflexión que se pudiera usar de forma directa o indirecta para acceder al objeto Type que representa
T. Por ejemplo, el objeto Type paraTpuede obtenerse a partir de un tipo de matriz cuyo tipo de elemento esTo de un tipo genérico que tieneTcomo argumento de tipo.Un método
Men la pila de llamadas de cualquier subproceso, dondeMes un método deTo un método de nivel de módulo definido en el ensamblado.Un delegado a un método estático definido en un módulo del ensamblado.
Si solo existe un elemento de esta lista para un solo tipo o un método del ensamblado, el runtime no puede descargar el ensamblado.
Nota
El runtime no descarga realmente el ensamblado hasta que se han ejecutado los finalizadores de todos los elementos de la lista.
Para realizar el seguimiento de la duración, se considera que en el ensamblado que contiene la definición del tipo genérico o en un ensamblado que contiene la definición de uno de sus argumentos de tipo se ha definido un tipo genérico construido List<int> (en C#) o List(Of Integer) (en Visual Basic) creado y usado en la generación de un ensamblado recopilable. El ensamblado exacto que se usa es un detalle de implementación y está sujeto a cambios.
Restricciones de los ensamblados recopilables
Las siguientes restricciones se aplican a los ensamblados recopilables:
Referencias estáticas
Los tipos de un ensamblado dinámico normal no pueden tener referencias estáticas a tipos definidos en un ensamblado recopilable. Por ejemplo, si define un tipo normal que hereda de un tipo de un ensamblado recopilable, se produce una excepción NotSupportedException. Un tipo de un ensamblado recopilable puede tener referencias estáticas a un tipo de otro ensamblado recopilable, pero esto amplía la duración del ensamblado al que se hace referencia a la duración del ensamblado que hace referencia.
Las siguientes restricciones se aplican a los ensamblados de .NET Framework:
Interoperabilidad COM
No se pueden definir interfaces COM dentro de un ensamblado recopilable, ni ninguna instancia de tipos de un ensamblado recopilable se puede convertir en objetos COM. Un tipo de un ensamblado recopilable no puede actuar como contenedor CCW ni contenedor RCW. Pero los tipos de los ensamblados recopilables pueden usar objetos que implementen interfaces COM.
Invocación de plataforma
Los métodos que tienen el atributo DllImportAttribute no se compilan si se han declarado en un ensamblado recopilable. La instrucción OpCodes.Calli no se puede usar en la implementación de un tipo de un ensamblado recopilable y estos tipos no se pueden serializar en código no administrado. Pero se puede llamar al código nativo mediante el uso de un punto de entrada declarado en un ensamblado no recopilable.
Serialización
No se pueden serializar los objetos (en particular, delegados) definidos en ensamblados recopilables. Se trata de una restricción para todos los tipos transitorios emitidos.
Carga de ensamblados
La emisión de la reflexión es el único mecanismo admitido para cargar ensamblados recopilables. Los ensamblados cargados mediante cualquier otra forma de carga de ensamblados no se pueden descargar.
Objetos enlazados a un contexto
No se admiten las variables context-static. Los tipos de un ensamblado recopilable no pueden extender ContextBoundObject. Pero el código de los ensamblados recopilables puede usar objetos enlazados a un contexto definidos en otro lugar.
Datos thread-static
No se admiten las variables Thread-static.
Las restricciones siguientes se aplican a los ensamblados recopilables en .NET Framework y versiones de .NET anteriores a .NET 9:
Campos estáticos con
FixedAddressValueTypeAttributeLos campos estáticos definidos en ensamblados recopilables no pueden tener aplicado el atributo FixedAddressValueTypeAttribute.
