Los archivos de recursos son archivos que forman parte de una aplicación, pero no se compilan. Un ejemplo de estos archivos son los archivos de icono de ejemplo o los archivos de audio. Puesto que estos archivos no forman parte del proceso de compilación, se pueden cambiar sin tener que volver a compilar los archivos binarios. Si piensa localizar la aplicación, debe usar los archivos de recursos para todas las cadenas y los demás recursos que deben cambiarse al localizar la aplicación.
Precaución
Los recursos de los archivos .resx se pueden serializar mediante BinaryFormatter, que es no seguro. Incluya solo esos archivos .resx en el proceso de compilación de confianza.
En un proyecto de código administrado, abra la ventana de propiedades del proyecto. Puede abrir la ventana Propiedades de cualquiera de estas maneras:
Hacer clic con el botón derecho en el nodo de proyecto en el Explorador de soluciones y seleccionar Propiedades.
Escribir las propiedades del proyecto en el cuadro de búsqueda Ctrl+Q
Presionar Alt+Entrar en el Explorador de soluciones
Seleccione la pestaña Recursos . Puede agregar un archivo .resx si el proyecto no contiene ninguno y luego agregar y eliminar diferentes tipos de recursos y modificar recursos existentes.
Mejoras del Explorador de recursos en Visual Studio 2022 y versiones posteriores
Para usar el nuevo Explorador de recursos, debe tener un proyecto de .NET que contenga uno o varios archivos de recursos (.resx). Para abrir el Explorador de recursos, haga clic con el botón derecho en cualquier archivo de recursos en el Explorador de soluciones y seleccione Abrir con>Explorador de recursos. También puede usar el método abreviado de teclado Ctrl+Alt+R.
Al abrir el nuevo Explorador de recursos, en el lado izquierdo, verá información general de todos los recursos que ha almacenado junto con las configuraciones regionales de cada archivo. Puede configurar qué configuraciones regionales están visibles en la cuadrícula de datos. Esta interfaz le permite comparar traducciones en paralelo y editarlas en su lugar.
Búsqueda de cadenas de recursos
En la parte superior izquierda de la cuadrícula, puede usar el cuadro de búsqueda para realizar un texto de búsqueda de todos los archivos de recursos. Para buscar un recurso, escriba el cuadro de búsqueda de la barra de herramientas y presione Entrar. La cuadrícula de datos mostrará solo los recursos que coinciden con la consulta en su nombre, valor o comentario. Puede usar caracteres comodín (*) para realizar coincidencias parciales y comillas (") para realizar coincidencias exactas.
Adición de comentarios a traducciones específicas de un recurso
Los comentarios son una manera útil de proporcionar más información o contexto para un recurso, como el significado, el uso o el tono de una cadena. En el Explorador de recursos, puede agregar comentarios a cada traducción de un recurso y verlos todos a la vez en la cuadrícula de datos.
Para agregar un comentario a un recurso, seleccione la celda que corresponde a la traducción en la que desea comentar y haga clic en el botón Editar comentario de la barra de herramientas o presione Mayús+Entrar. Aparece un cuadro de comentario debajo de la celda, donde puede escribir el comentario. Presione Entrar para guardar el comentario o Esc para descartarlo.
Para editar o eliminar comentarios existentes, haga clic en el cuadro de comentario o use el mismo método abreviado de teclado. Para ver todos los comentarios de un recurso, busque el icono de triángulo pequeño en la esquina de cada celda que tenga un comentario. Puede mantener el puntero sobre el icono para ver una información sobre herramientas con el texto del comentario o hacer clic en él para abrir el cuadro de comentario.
Los comentarios están disponibles para varios usuarios de los archivos de recursos. El traductor, un desarrollador o un administrador de recursos puede dejar notas, preguntas, explicaciones o advertencias junto con las traducciones. Un pequeño icono en la esquina de cada celda indica la presencia de un comentario.
Filtrado de recursos
Para filtrar los recursos, haga clic en el icono de filtro de la barra de herramientas y seleccione los criterios que desea aplicar. Puede filtrar los recursos por nombre, valor, comentario, tipo o archivo.
Filter
Descripción
Nombre
Muestra solo los recursos que tienen un nombre o prefijo determinado.
Valor
Muestra solo los recursos que tienen un valor determinado o contienen una cadena determinada.
Comentario
Muestra solo los recursos que tienen un comentario o contienen una cadena determinada en su comentario.
Tipo
Mostrar solo los recursos que tienen un tipo determinado, como cadena, imagen o icono.
Archivo
Mostrar solo los recursos que pertenecen a un archivo o referencia cultural determinados.
Puede combinar varios filtros para restringir los resultados y borrarlos haciendo clic en el botón Borrar filtro.
Validación y advertencias
Los marcadores de posición son tokens especiales que se reemplazan por valores dinámicos en tiempo de ejecución, como {0}, {1} o {name}. Si usa marcadores de posición en los recursos, debe asegurarse de que son coherentes en todas las localizaciones; de lo contrario, es posible que vea errores o comportamiento inesperado en la aplicación.
El nuevo Explorador de recursos valida automáticamente los marcadores de posición de cada recurso y muestra un icono de advertencia si hay un error de coincidencia entre la referencia cultural predeterminada y cualquier otra localización. Por ejemplo, si el valor predeterminado de un recurso es "Hello, {name}!" y el valor español es "¡Hola, {nombre}!", verá un icono de advertencia que muestra que el nombre del marcador de posición es diferente. Puede mantener el puntero sobre el icono para ver una información sobre herramientas con los detalles del error de coincidencia y hacer clic en él para corregirlo.
Las traducciones que faltan son otro problema común que puede afectar a la experiencia del usuario de la aplicación. Si no proporciona una traducción para un recurso en una determinada referencia cultural, la aplicación volverá a la referencia cultural predeterminada, lo que podría no ser adecuado o deseable para algunos usuarios. El Explorador de recursos le ayuda a evitar este problema mostrando un icono de advertencia si no hay ningún valor para un recurso en una referencia cultural determinada. Por ejemplo, si> tiene un recurso con un valor predeterminado de File y ningún valor para la referencia cultural francesa, verá un icono de advertencia que muestra que falta la traducción. Puede mantener el puntero sobre el icono para ver una información sobre herramientas con el mensaje Sin valor y seleccionarlo para agregar un valor.
Opciones de personalización
El Explorador de recursos de Visual Studio 2022 y versiones posteriores es compatible con lectores de pantalla y tecnología de asistencia, para que sea más accesible para los desarrolladores con discapacidades visuales o discapacidades. Puede usar métodos abreviados de teclado para navegar por la cuadrícula de datos, editar valores y comentarios y realizar acciones comunes. También puede usar el narrador para leer el contenido de cada celda, así como la información sobre herramientas y las advertencias.
Para ajustar el nivel de zoom, use el control deslizante de zoom en la barra de herramientas o los métodos abreviados de teclado Ctrl+= y Ctrl+-, para acercar o alejar. Use Ctrl+0 para restablecer el nivel de zoom al valor predeterminado.
El tema del Explorador de recursos es coherente con el resto del entorno de Visual Studio. Puede elegir entre temas claros, oscuros o azules, y el Explorador de recursos se adaptará en consecuencia. También puede cambiar la fuente y los colores de la cuadrícula de datos mediante el cuadro de diálogo Herramientas>Opciones>Entorno>Fuentes y colores.
Recursos en otros tipos de proyecto
Los recursos se administran de manera diferente en los proyectos de .NET que en otros tipos de proyecto. Para obtener más información sobre los recursos en:
Obtenga información sobre cómo usar recursos compartidos estáticos y dinámicos para crear una interfaz de usuario de la interfaz de usuario de aplicaciones multiplataforma (MAUI) de .NET. Vea cómo los estilos pueden hacer que la interfaz de usuario sea coherente y accesible.
Obtenga información sobre cómo especificar el icono que muestra el Explorador de archivos y la barra de tareas de Windows para una aplicación compilada de Visual Basic o C#.
Cree archivos de recursos para aplicaciones .NET. Compile archivos de texto con recursos de cadena, archivos XML o binarios mediante programación, o archivos XML con datos de cadena, imagen u objeto.
Cree o recupere datos de archivos de recursos XML (.resx) mediante programación a través del uso de tipos y miembros en el espacio de nombres System.Resources de la biblioteca de clases .NET.
Recupere recursos en aplicaciones .NET. Empaquete recursos para la referencia cultural predeterminada (neutra) con el ensamblado principal y cree un ensamblado satélite para cada referencia cultural.