Cómo: Crear archivos de recursos para sitios Web ASP.NET (Visual Studio)

Artículo
10/22/2014

Actualización: noviembre 2007

Un archivo de recursos es un archivo XML que puede contener cadenas y otros recursos, como rutas de acceso al archivo de imagen. Estos archivos normalmente se utilizan para almacenar cadenas de la interfaz de usuario que se deben traducir a otros idiomas. Esto se debe a que puede crear un archivo de recursos independiente para cada idioma al que desee traducir una página Web.

Los archivos de recursos globales están disponibles en cualquier página o componente del sitio Web. Los archivos de recursos locales se asocian a una sola página Web, a un control de usuario o a una página principal y contienen los recursos sólo de esa página. Para obtener más información, vea Información general sobre los recursos de las páginas Web ASP.NET.

En Visual Web Developer, puede utilizar el editor de recursos administrados para crear los archivos de recursos globales o locales. En los archivos de recursos locales, también puede generar recursos neutros para la referencia cultural directamente desde una página Web del diseñador.

Crear recursos manualmente

Para crear un archivo de recursos manualmente

Asegúrese de que el sitio Web tiene una carpeta en la que almacenar el archivo de recursos mediante una de las siguientes acciones:
- Si está creando un archivo de recursos global, debe tener una carpeta denominada App_GlobalResources. Para crear la carpeta, en Explorador de soluciones, haga clic con el botón secundario del mouse en el nombre del sitio Web, haga clic en Agregar carpeta y, a continuación, en Carpeta App_GlobalResources. Sólo puede haber una de estas carpetas en una aplicación y debe estar ubicada en la raíz de la aplicación.
- Si está creando un archivo de recursos local, debe tener una carpeta denominada App_LocalResources. Para crear la carpeta, en Explorador de soluciones, haga clic con el botón secundario del mouse en el nombre del sitio Web, haga clic en Agregar carpeta y, a continuación, en Carpeta App_LocalResources. Puede haber muchas carpetas de este tipo en una aplicación y pueden estar ubicadas en cualquier nivel de la misma.

Para crear un archivo de recursos, haga clic con el botón secundario del mouse en las carpetas App_GlobalResources o App_LocalResources y, a continuación, haga clic en Agregar nuevo elemento.

Nota:
Los archivos de recursos globales deben estar en la carpeta App_GlobalResources. Si intenta crear un archivo .resx fuera de esta carpeta, Visual Web Developer le indica que lo cree en la carpeta.

En la opción Plantillas instaladas de Visual Studio del cuadro de diálogo Agregar nuevo elemento, haga clic en Archivo de recursos de ensamblado.
En el cuadro Nombre, escriba un nombre para el archivo de recursos y, a continuación, haga clic en Agregar.

Visual Web Developer abre el archivo en el Editor de recursos administrados. El editor muestra una cuadrícula donde puede escribir nombres (claves), valores y comentarios opcionales.

Escriba los nombres y valores de las claves para cada recurso que necesite en la aplicación y, a continuación, guarde el archivo.

Nota:
No intente incrustar un gráfico directamente en un archivo de recursos porque los controles no leerán la cadena de recurso como archivo de imagen transmitido. Los archivos de recursos representan los gráficos almacenando la dirección URL del gráfico como cadena.

Para crear archivos de recursos para idiomas adicionales, copie el archivo en el Explorador de soluciones o en el Explorador de Windows y, a continuación, cámbiele el nombre mediante uno de los modelos siguientes:
- Para archivos de recursos globales:
  
  nombre.idioma.resx
  
  nombre.idioma-referencia cultural.resx
- Para archivos de recursos locales:
  
  nombreDePáginaOControl.extensión.idioma.resx
  
  nombreDePáginaOControl.extensión.idioma-referencia cultural.resx
Por ejemplo, si crea un archivo de recursos global denominado WebResources.resx para la traducción al árabe egipcio, asigne el nombre WebResources.ar-eg.resx al archivo copiado. Para crear un archivo de recursos relacionado para la traducción al español sin especificar ninguna referencia cultural, asigne el nombre WebResources.es.resx al archivo copiado. Tenga en cuenta que, para los archivos de recursos locales, el nombre del archivo de recursos es el nombre de la página o del control, incluidos la extensión de nombre de archivo y, a continuación, el idioma y la información de referencia cultural.
Abra el archivo copiado y traduzca cada valor, sin cambiar los nombres (claves).
Repita los pasos 6 y 7 por cada idioma adicional que desee utilizar.

Crear recursos a partir de una página Web

La característica siguiente no está disponible con Visual Web Developer Express.

Para generar un archivo de recursos local desde una página Web ASP.NET

Abra la página para la que desee crear un archivo de recursos.
Cambie a la vista Diseño.
En el menú Herramientas, haga clic en Generar recurso local.

Visual Web Developer crea la carpeta App_LocalResources si aún no existe. Visual Web Developer crea después un archivo de recursos neutros para la referencia cultural de la página actual, que incluye un par de clave-nombre por cada propiedad de control o de página que requiera localización. Finalmente, Visual Web Developer agrega un atributo meta a cada control de servidor Web ASP.NET con el fin de configurar el control para utilizar la localización implícita. Para obtener más información sobre localización implícita y explícita, vea Información general sobre los recursos de las páginas Web ASP.NET y Cómo: Utilizar recursos para establecer valores de propiedad en los controles de servidor Web (Visual Studio).

Escriba los valores de cada recurso que necesite en la aplicación y, a continuación, guarde el archivo.

Nota:
No intente incrustar un gráfico directamente en un archivo de recursos porque los controles no leerán la cadena de recurso como archivo de imagen transmitido. Los archivos de recursos representan los gráficos almacenando la dirección URL del gráfico como cadena.

Si no se muestran los últimos cambios en los recursos, actualice la vista Diseño; para ello, cambie a la vista Código fuente y vuelva a la vista Diseño.
Cree archivos de recursos para otros idiomas siguiendo los pasos 6 y 8 del procedimiento anterior.

Para generar un archivo de recursos global en Visual Web Developer

En el Explorador de soluciones, haga clic con el botón secundario en el nombre del sitio web, haga clic en Agregar nuevo elemento y, a continuación, en Archivo de recursos.

Visual Web Developer le pregunta si desea colocar el archivo en la carpeta App_GlobalResources y se ofrece para crearla.
Haga clic en Sí.

Escriba los valores de cada recurso que necesite en la aplicación y, a continuación, guarde el archivo.

Nota:
No intente incrustar un gráfico directamente en un archivo de recursos porque los controles no leerán la cadena de recurso como archivo de imagen transmitido. Los archivos de recursos representan los gráficos almacenando la dirección URL del gráfico como cadena.

Si no se muestran los últimos cambios en los recursos, actualice la vista Diseño; para ello, cambie a la vista Código fuente y vuelva a la vista Diseño.

Para crear archivos de recursos para idiomas adicionales, copie el archivo en el Explorador de soluciones o en el Explorador de Windows y, a continuación, cámbiele el nombre mediante uno de los modelos siguientes:

nombre.idioma.resx

nombre.idioma-referencia cultural.resx

Nota:
En los nombres de archivos de recursos no incluya .aspx para evitar que se produzcan conflictos de nomenclatura. Por ejemplo, la carpeta del recurso no puede contener dos archivos con nombres como resTestPage.resx y resTestPage.aspx.resx. En este caso, la resolución de los nombres de archivo en la compilación crearía un conflicto de nomenclatura, con el consiguiente error en tiempo de compilación.

En los nombres de archivos de recursos no incluya .aspx para evitar que se produzcan conflictos de nomenclatura. Por ejemplo, la carpeta del recurso no puede contener dos archivos con nombres como resTestPage.resx y resTestPage.aspx.resx. En este caso, la resolución de los nombres de archivo en la compilación crearía un conflicto de nomenclatura, con el consiguiente error en tiempo de compilación.