Compartir a través de


Cómo: Incluir recursos en tiempo de compilación

Normalmente, es más fácil y práctico trabajar con la organización predeterminada, que incluye todos los recursos en un mismo archivo de script de recursos (.rc). No obstante, durante la compilación podrán agregarse recursos de otros archivos al proyecto actual si se enumeran en el cuadro Directivas de tiempo de compilación del cuadro de diálogo Archivos de inclusión de recursos.

Hay varias razones para incluir recursos en archivos distintos del archivo .rc principal:

  • Para agregar comentarios a instrucciones de recursos que no se eliminen cada vez que se guarde el archivo .rc.

    Los editores de recursos no leen directamente los archivos .rc o resource.h, sino que el compilador los compila en archivos .aps para poder ser utilizados por los editores. Estos archivos son pasos de compilación y solamente contienen datos simbólicos. Como con los procesos de compilación normales, toda la información que no sea simbólica (por ejemplo, los comentarios) se descartará durante la compilación. Siempre que el archivo .aps pierda sincronización con el archivo .rc, éste se regenerará (por ejemplo, si se ejecuta el comando Guardar, el editor de recursos sobrescribirá los archivos .rc y resource.h). Los cambios efectuados en los propios recursos permanecerán en el archivo .rc, pero no así los comentarios, que se perderán al sobrescribirse el archivo .rc.

  • Para incluir recursos que ya han sido desarrollados y probados y, por tanto, no necesiten más modificaciones (los archivos que se incluyan sin la extensión .rc no podrán editarse en los editores de recursos).

  • Para incluir recursos que estén siendo utilizados por varios proyectos diferentes o que formen parte de un sistema de control de versiones del código fuente y que, por lo tanto, deban existir en una ubicación centralizada donde las modificaciones afecten a todos los proyectos.

  • Para incluir recursos (por ejemplo, recursos RCDATA) que tengan un formato personalizado. Los recursos RCDATA a veces tienen requisitos especiales: por ejemplo, no puede utilizarse una expresión como valor del campo nameID. Para obtener más información, consulte la documentación de Windows SDK.

Si algunas secciones de sus archivos .rc ya existentes cumplen cualquiera de estas condiciones, deberá situarlas en uno o varios archivos .rc independientes e incluir éstos en el proyecto usando el cuadro de diálogo Archivos de inclusión de recursos. El archivo Projectname.rc2, creado en el subdirectorio \res de un proyecto nuevo, se utilizará para este fin.

Para incluir recursos en un proyecto en tiempo de compilación

  1. Sitúe los recursos en un archivo de script de recursos con un nombre único. No use projectname.rc, pues éste es el nombre que utiliza el archivo principal de script de recursos.

  2. En la Vista de recursos, haga clic con el botón secundario en el archivo .rc y elija Archivos de inclusión de recursos en el menú contextual.

  3. En el cuadro Directivas de tiempo de compilación, agregue la directiva #include del compilador para incluir el nuevo archivo de recursos en el archivo principal de recursos del entorno de desarrollo.

    Los recursos de los archivos incluidos siguiendo este método pasarán a formar parte del archivo ejecutable durante la compilación. Sin embargo, no se podrán editar o modificar directamente cuando se esté trabajando en el archivo .rc principal del proyecto. Los archivos .rc incluidos deberán abrirse de forma independiente. Los archivos que se incluyan sin la extensión .rc no podrán editarse en los editores de recursos.

Para obtener información sobre cómo agregar recursos a proyectos administrados, vea Recursos de aplicaciones en la Guía del desarrollador de .NET Framework. Para obtener información sobre cómo agregar manualmente archivos de recursos a proyectos administrados, cómo obtener acceso a recursos, cómo mostrar recursos estáticos y cómo asignar cadenas de recursos a propiedades, vea Tutorial: Adaptar formularios Windows Forms y Walkthrough: Using Resources for Localization with ASP.NET.

Requisitos

Win32

Vea también

Referencia

Archivos de recursos (Visual Studio)

Editores de recursos