Tutorial: Crear archivos DLL satélite administrados
Actualización: noviembre 2007
Los archivos DLL satélite son útiles para almacenar archivos de recursos, tales como iconos, mapas de bits y cadenas de recursos, en una ubicación centralizada para usarlos en complementos y otros proyectos de automatización. Otros proyectos o complementos pueden reutilizar archivos DLL satélite. Además, separar las cadenas y otros recursos del complemento facilita la realización de cambios centralizados o la adaptación de recursos a diferentes idiomas.
El Visual Studio .NET 2002 y Visual Studio .NET 2003 utilizaban entradas del Registro para SatelliteDllPath y SatelliteDllName. Sin embargo, en Visual Studio 2005, las entradas del Registro se han sustituido por entradas en el archivo .Addin. Cuando necesite un recurso en el proyecto, cargue el complemento y Visual Studio lo pedirá al archivo DLL satélite, igual que los demás componentes administrados. Por consiguiente, especificar en el código una ruta de acceso de recurso no es necesario. Además, en lugar de utilizar el método #id para especificar un Id. de recurso, utilice @<nombre de recurso> (donde "<nombre de recurso> es el nombre del recurso, por ejemplo @Icon1 o @String1). El símbolo @ indica a Visual Studio que debe buscar el recurso en el archivo DLL satélite.
Crear archivos DLL satélite administrados
El procedimiento siguiente muestra cómo crear un archivo DLL satélite que contiene recursos de icono y de cadena, y cómo alterar un complemento para que tenga acceso a estos recursos. Utiliza un complemento que tiene un Cuadro Acerca de, que requiere recursos de icono y de cadena. Normalmente, si crea un complemento con un Cuadro Acerca de, se proporciona un icono predeterminado y texto. El procedimiento siguiente muestra cómo reemplazarlos por un icono y texto de su elección.
Para crear un archivo DLL satélite administrado
En el menú Archivo, elija Nuevo y haga clic en Proyecto.
Aparece el cuadro de diálogo Nuevo proyecto.
Expanda Otros tipos de proyectos y, a continuación, seleccione Proyectos de extensibilidad.
En el panel Plantillas, seleccione Complemento de Visual Studio.
Siga las indicaciones del Asistente para complementos de Visual Studio. En la página Selección de información para Ayuda - Acerca de, active la casilla Sí, me gustaría que mi complemento ofreciera información en el cuadro Acerca de. Acepte los valores predeterminados restantes.
En el Explorador de soluciones, seleccione el proyecto de complemento y, en el Menú Proyecto, haga clic en Mostrar todos los archivos.
Haga clic en la opción Agregar referencia del menú Proyecto.
En la ficha .NET, haga clic en System.Drawing y, a continuación, haga clic en Aceptar.
En el Explorador de soluciones, haga clic con el botón secundario del mouse en el proyecto de complemento.
Elija Agregar y haga clic en Nuevo elemento.
Seleccione Archivo de recursos en la lista Plantillas y haga clic en el botón Agregar. Deje su nombre predeterminado (Resources1.resx).
Esto inicia el Editor de recursos de Visual Studio.
De forma predeterminada, esto crea un archivo de recursos denominado Resource1.resx.
En Resource1.resx, seleccione Iconos en la lista desplegable Cadenas de la parte superior (el botón situado más a la izquierda de la parte superior).
En la lista desplegable Agregar recurso, haga clic en Agregar nuevo icono. Por ahora, deje el nombre predeterminado (Image1.bmp) y haga clic en Agregar.
También puede seleccionar una imagen de mapa de bits existente para el icono siempre que sea de 16 x 16 píxeles y 16 colores o Color verdadero. Los iconos personalizados para los complementos deben ser de 16 x 16 píxeles y 16 colores o Color verdadero.
Una vez que el icono se abre en el Editor de iconos, utilice las herramientas para modificarlo. Cuando termine, cierre el Editor de iconos y guarde los cambios.
Seleccione Agregar nueva cadena en la lista desplegable Agregar recurso.
Haga clic en el primer cuadro de la columna Nombre.
Esto crea un nuevo recurso de cadena predeterminado denominado String1.
Escriba Línea uno en el cuadro Valor.
Éste es el valor para el primer recurso de cadena.
Cree dos recursos de cadena más y llámelos "Línea dos" y "Línea tres".
Cierre el Editor de recursos y guarde los cambios.
En el Explorador de soluciones, haga clic con el botón secundario del mouse en Resource1.resx y seleccione Propiedades.
En la Ventana vPropiedades, cambie Acción de generación de Recurso incrustado a Ninguno.
Esto evita que el recurso se genere en el ensamblado del complemento.
Genere el proyecto.
Cree el archivo DLL de recursos satélite. Esto se hace en un proceso de dos pasos, utilizando ResGen y a continuación AL (Herramienta Assembly Linker) para generar el archivo DLL satélite.
Haga clic en el menú Inicio de Windows, elija Todos los programas, seleccione Microsoft Visual Studio 2005, elija Visual Studio Tools y, por último, haga clic en Símbolo del sistema de Microsoft Visual Studio 2005.
Esto establece ciertas variables de entorno para que pueda hacer referencia más fácilmente a las herramientas de Visual Studio.
En el símbolo del sistema, vaya a la carpeta que contiene el archivo .resx y escriba Resgen Resource1.resx.
Resgen es una utilidad que compila el archivo .resx especificado en un archivo .resources. Para obtener más información, vea Generador de archivos de recursos (Resgen.exe).
En el símbolo del sistema, escriba lo siguiente: Al.exe /embed:Resource1.resources /culture:en-US /out:<Add-In Name>.resources.dll.
Reemplace <Add-In Name> por el nombre del complemento. Por ejemplo, si el proyecto de complemento se llama MyAddin, el modificador /out: sería /out:MyAddin.resources.dll. El nombre de /out: debe coincidir con el nombre el proyecto, o el archivo DLL de recursos no se encontrará.
Al.exe (Assembly Linker) convierte el archivo .resources especificado en un archivo DLL al que puede hacer referencia en el complemento (puede cambiar el modificador /culture a un idioma diferente del inglés). Para obtener más información, vea Herramienta Assembly Linker (Al.exe).
Usando el Explorador de Windows, examine el directorio de archivos DLL del complemento y cree una carpeta denominada en-US (para Inglés de EE.UU., porque escribió en-US como valor de referencia cultural en Al).
Copie el archivo <Nombre de complemento>.resources.dll en la nueva carpeta en-US.
Utilizando el Explorador de Windows, vaya al directorio Addins. Normalmente, <drive>:\Documents and Settings\<nombre de usuario>\My Documents\Visual Studio 2005\Addins.
Modifique el archivo de definición de complemento de Visual Studio haciendo lo siguiente:
Haga clic con el botón secundario en el archivo de definición del complemento y seleccione Abrir con en el menú de acceso directo. Seleccione Bloc de notas en la lista de programas.
Dentro de las etiquetas <Addin></Addin>, realice las modificaciones siguientes:
<Addin> <FriendlyName>@String1</FriendlyName> <Description>@String2</Description> <AboutBoxDetails>@String3</AboutBoxDetails> <AboutIconData>@Icon1</AboutIconData> <Assembly><installation root>\my documents\visual studio 2005\Projects\MyAddin1\MyAddin1\bin\MyAddin1.dll</Assembly> <FullClassName>MyAddin1.Connect</FullClassName> <LoadBehavior>0</LoadBehavior> <CommandPreload>0</CommandPreload> <CommandLineSafe>0</CommandLineSafe> </Addin>Reemplace <installation root> en las fichas <Assembly></Assembly> con la ruta del archivo de su equipo.
La entrada Friendlyname cambia el nombre del complemento a Line1, que es lo que escribió para String1 en el archivo Resource1.resx. La descripción del cuadro Ayuda Acerca de contiene ahora "Line2" y la entrada AboutIconData coincide con el icono del cuadro Ayuda Acerca de creado en el paso siete (7).
Vuelva a generar el proyecto y seleccione el complemento en el Administrador de complementos.
En el menú Ayuda, haga clic en el comando Acerca de Microsoft Visual Studio y seleccione Line1 (el nombre del complemento) en la lista.
Verá su nuevo icono personalizado y las tres cadenas creadas en el Cuadro Acerca de.
Vea también
Tareas
Cómo: Obtener acceso a los recursos en archivos DLL satélite