¿Cómo creo y uso un "Ensamblaje de referencia" de solo metadatos .NET?

Question

Desde la versión 3.0, .NET instala un grupo de diferentes 'ensamblados de referencia' en C: \ Archivos de programa \ Conjuntos de referencia \ Microsoft ...., para admitir diferentes perfiles (por ejemplo, perfil de cliente .NET 3.5, perfil de Silverlight). Cada uno de estos es un ensamblado .NET apropiado que contiene solo metadatos, sin código IL, y cada ensamblaje está marcado con el ReferenceAssemblyAttribute. Los metadatos están restringidos a los tipos y miembros disponibles bajo el perfil correspondiente: así es como Intellisense muestra un conjunto restringido de tipos y miembros. Los ensambles de referencia no se utilizan en tiempo de ejecución.

Me enteré un poco al respecto desde this blog post.

Me gustaría crear y usar un conjunto de referencia para mi biblioteca.

1. ¿Cómo creo un ensamblado solo de metadatos? ¿Hay algún indicador de compilador o postprocesador ildasm?
2. ¿Hay atributos que controlan qué tipos se exportan a diferentes 'perfiles'?
3. ¿Cómo funciona la resolución del conjunto de referencia en tiempo de ejecución? Si tuviera el conjunto de referencia presente en mi directorio de aplicaciones en lugar del ensamblado "real", y no en el GAC, continuaría la prueba y se desencadenaría mi evento AssemblyResolve para que puede suministrar el ensamblaje real en tiempo de ejecución?

Cualquier idea o consejos sobre dónde podría obtener más información sobre esto sería muy apreciada.

Actualización: Mirando a su alrededor un poco, veo el .NET 3.0 '' ensamblados de referencia parecen tener algo de código, y la única Reference Assembly attribute se añadió en .NET 4.0. Entonces, el comportamiento podría haber cambiado un poco con el nuevo tiempo de ejecución.

¿Por qué? Para mi biblioteca de complementos de Excel-DNA (http://exceldna.codeplex.com), creo el complemento .xll de un solo archivo empaquetando los ensamblados a los que se hace referencia en el archivo .xll como recursos. Los ensamblados empaquetados incluyen el código de complemento del usuario, así como la biblioteca administrada Excel-DNA (que puede ser referenciada por el ensamblado del usuario).

Suena bastante complicado, pero funciona maravillosamente bien la mayor parte del tiempo: el complemento es un solo archivo pequeño, por lo que no hay problemas de instalación de distribución. Me encuentro con problemas (no inesperados) debido a las diferentes versiones: si hay una versión anterior de la biblioteca administrada Excel-DNA como archivo, el tiempo de ejecución cargará eso en lugar del empaquetado (nunca tengo la oportunidad de interferir con el cargando).

Espero hacer un ensamblaje de referencia para mi parte administrada Excel-DNA que los usuarios pueden señalar al compilar sus complementos. Pero si erróneamente tienen una versión de este ensamblado en tiempo de ejecución, el tiempo de ejecución no debería cargarlo, y darme la oportunidad de cargar el ensamblaje real de los recursos.

Answer 1

Para crear un conjunto de referencia, deberá añadir esta línea a su archivo AssemblyInfo.cs:

[assembly: ReferenceAssembly] 

Para cargar otros, se puede hacer referencia a ellos como de costumbre a partir de las referencias del proyecto VisualStudio, o dinámicamente en tiempo de ejecución usando:

Assembly.ReflectionOnlyLoad()

o

Assembly.ReflectionOnlyLoadFrom()

---

Si ha añadido una referencia a una de metadatos/referencia de ensamblado utilizando VisualStudio, a continuación, IntelliSense y la construcción de su proyecto trabajará muy bien, sin embargo, si se intenta ejecutar su aplicación contra uno, obtendrá un error:

System.BadImageFormatException: Cannot load a reference assembly for execution.

Así que la expectativa es que en tiempo de ejecución que le sustituya en un montaje real que tiene la misma firma de metadatos.

Si ha cargado un ensamblaje dinámicamente con Assembly.ReflectionOnlyLoad(), entonces solo puede realizar todas las operaciones de reflexión contra él (lea los tipos, métodos, propiedades, atributos, etc., pero no puede invocar dinámicamente ninguno de ellos).

---

Tengo curiosidad por saber cuál es su caso de uso para crear un conjunto de solo metadatos. Nunca tuve que hacer eso antes, y me encantaría saber si ha encontrado algún uso interesante para ellos ...

Answer 2

Sí, esto es nuevo para .NET 4.0. Estoy bastante seguro de que esto se hizo para evitar los desagradables problemas de versiones en los paquetes de servicio .NET 2.0. El mejor ejemplo es la sobrecarga WaitHandle.WaitOne (int), agregada y documentada en SP2. Una sobrecarga popular porque evita tener que adivinar el valor correcto para * exitContext "en la sobrecarga de WaitOne (int, bool). El problema es que el programa se dispara cuando se ejecuta en una versión de 2.0 que es anterior a SP2. ya sea de diagnóstico. el aislamiento de los conjuntos de referencia asegura que esto no puede suceder de nuevo.

yo creo esos conjuntos de referencia se crearon partiendo de una copia de los ensamblados compilados (como se hizo en las versiones anteriores) y ejecutarlos a través de una herramienta que elimina el IL del ensamblado. Sin embargo, esa herramienta no está disponible para nosotros, no hay nada en las carpetas bin/netfx 4.0 del subdirectorio SDK de Windows 7.1 que podría hacer esto. No es exactamente una herramienta que se usa con frecuencia, así que probablemente no calidad de producción :)

Answer 3

Puede tener suerte con la Biblioteca Cecil (de Mono); Creo que la implementación permite la funcionalidad de ILMerge, también podría escribir ensamblajes de solo metadatos.

He escaneado el código base (documentación es escasa), pero no he encontrado ninguna pista obvias sin embargo ...

YYMV

Answer 4

Si usted todavía está interesado en esta posibilidad, he hecho una bifurcación del proyecto il-reeck basado en Mono.Cecil que acepta un argumento de línea de comando "/ meta" para generar un ensamblado de metadatos solo para el público y tipos protegidos.

https://github.com/KarimLUCCIN/il-repack/tree/xna

(lo probé en XNA Framework completo y su trabajo que yo sepa ...)