Tutorial: Cargar recursos de un ensamblado satélite

Actualización: noviembre 2007

En este tutorial se muestra cómo cargar una cadena de recursos de un ensamblado satélite utilizando Windows Presentation Foundation (WPF) Designer for Visual Studio. Esto facilita la localización de aplicaciones WPF. 

En este tutorial realizará las tareas siguientes:

  • Crear el proyecto.

  • Habilitar el ensamblado satélite.

  • Crear y tener acceso a una cadena de recursos.

Cuando haya finalizado, tendrá una aplicación simple que recupera una cadena de un ensamblado satélite.

Nota:

Los cuadros de diálogo y comandos de menú que verá pueden variar con respecto a los descritos en la Ayuda en función de su edición o configuración activa. Para cambiar su configuración, elija Importar y exportar configuraciones en el menú Herramientas. Para obtener más información, vea Valores de configuración de Visual Studio.

Requisitos previos

Necesita los componentes siguientes para completar este tutorial:

  • Visual Studio 2008.

Creación del proyecto

El primer paso consiste en crear el proyecto para la aplicación.

Para crear el proyecto

  1. Cree un nuevo proyecto de aplicación WPF en Visual Basic o en Visual C# denominado ResourceTest. Para obtener más información, vea Cómo: Crear un nuevo proyecto de aplicación de WPF.

    Window1.xaml se abrirá en WPF Designer.

  2. En el Cuadro de herramientas, arrastre un control Button a la superficie de diseño.

  3. Haga doble clic en el botón para crear un controlador de eventos Click para el control de botón.

Habilitar el ensamblado satélite

Para habilitar el ensamblado satélite, es preciso hacer pequeños cambios en los archivos de proyecto y AssemblyInfo.

Para habilitar el ensamblado satélite

  1. Abra AssemblyInfo.cs o AssemblyInfo.vb en el Editor de código. Para ver el archivo en el Explorador de soluciones, tendrá que hacer clic en Mostrar todos los archivos.

  2. Quite la marca de comentario de la línea siguiente.

    //[assembly: NeutralResourcesLanguage("en-US", UltimateResourceFallbackLocation.Satellite)]

    '<Assembly: NeutralResourcesLanguage("en-US", UltimateResourceFallbackLocation.Satellite)>

  3. Guarde la solución.

  4. En el Explorador de soluciones, haga clic con el botón secundario en el proyecto ResourceTest y seleccione Descargar el proyecto.

    Visual Studio descargará el proyecto ResourceTest.

  5. En Explorador de soluciones, haga clic con el botón secundario en el proyecto ResourceTest y seleccione Editar ResourceTest.csproj o Editar ResourceTest.vbproj.

    El archivo de proyecto se abrirá en el Editor XML.

  6. Inserte el siguiente XML en el mismo nivel de los elementos <PropertyGroup>.

    <PropertyGroup>
    <UICulture>en-US</UICulture>
</PropertyGroup>

  7. Guarde y cierre el archivo.

  8. En el Explorador de soluciones, haga clic con el botón secundario en el proyecto ResourceTest y seleccione Volver a cargar el proyecto.

  9. En el Explorador de soluciones, cambie el nombre de archivo RESX predeterminado de Resources.resx. a Resources.en-US.resx.

  10. En la ventana Propiedades, borre el valor de Herramienta personalizada del archivo de recursos.

Crear una cadena de recursos en el ensamblado satélite

Ahora cree una cadena en el archivo de recursos.

Para crear una cadena de recursos en el ensamblado satélite

  1. En el Explorador de soluciones, haga doble clic en Resources.en-US.resx.

    Resources.en-US.resx se abrirá en el Diseñador de recursos.

  2. Cambie el nombre de la cadena predeterminada de String1 a helloWorldString.

  3. Cambie el valor de helloWorldString a Hello world.

  4. Guarde y cierre el editor de recursos.

Obtener acceso a cadenas de recursos

Obtenga acceso a la cadena en el ensamblado satélite usando la clase ResourceManager.

Para tener acceso a la cadena de recursos

  1. En el Editor de código, abra Window1.xaml.cs o Window1.xaml.vb.

  2. Inserte el siguiente código en la parte superior de Window1.xaml.cs o window1.xaml.vb.

    using System.Reflection;
using System.Resources;

    Imports System.Reflection
Imports System.Resources

  3. Inserte el código siguiente en el controlador de eventos button1_Click.

    ResourceManager rm = new ResourceManager(
    "ResourceTest.Properties.Resources", 
     Assembly.GetExecutingAssembly());
MessageBox.Show(rm.GetString("helloWorldString"));

    Dim rm As New ResourceManager( _
    "ResourceTest.Resources", _
    Assembly.GetExecutingAssembly())
MessageBox.Show(rm.GetString("helloWorldString"))

  4. Presione F5 para generar y ejecutar la aplicación.

  5. Haga clic en el botón para ver el valor de cadena que se ha cargado del recurso satélite.

  6. Abra la carpeta Debug/en-us para ver el ensamblado satélite, que se denomina ResourceTest.resources.dll.

Vea también

Referencia

ResourceManager

Otros recursos

Implementar y localizar con WPF Designer

Codificación y localización

  • Last updated on