PDF de programación - Curso .NET con C# - Aplicaciones multi idioma

Curso .NET con C#
Servicio de Informática

Aplicaciones multi idioma

Índice de contenido
Variables de sesión.........................................................................................................................1
Session_Start..............................................................................................................................1
Session_End (Evento) ................................................................................................................1
Global.asax..................................................................................................................................2
Archivo de configuración.................................................................................................................2
Creación de un valor de configuración.........................................................................................3
Utilización del valor de configuración...........................................................................................5
Leer el idioma del navegador..........................................................................................................5
Internacionalización con .NET.........................................................................................................6
Internacionalización del formulario de trabajo..............................................................................6
Internacionalización de avisos y descripciones............................................................................9
Valores globales........................................................................................................................12
Imágenes...................................................................................................................................13
La Clase ClaseIdioma...................................................................................................................15
Incluir la clase............................................................................................................................15
Especificar un idioma para un objeto.........................................................................................16

Variables de sesión
ASP.NET proporciona dos eventos que ayudan a administrar las sesiones de usuario: los eventos
Session_Start, que se desencadena cuando comienza una nueva sesión, y Session_End, que se
desencadena cuando se abandona o expira una sesión.
Session_Start
Puede controlar el evento Session_Start agregando una subrutina denominada Session_Start al
archivo Global.asax. La subrutina Session_OnStart se ejecuta al principio de una solicitud si ésta
inicia una nueva sesión. Se iniciará una nueva sesión si se crea una solicitud que no contenga
ningún valor SessionID o si la propiedad SessionID incluida en la solicitud hace referencia a una
sesión expirada.
Puede utilizar el evento Session_Start para inicializar las variables de sesión, así como para
realizar el seguimiento de la información relacionada con la sesión.

Session_End (Evento)
Puede controlar el evento Session_End agregando una subrutina denominada Session_OnEnd al
archivo Global.asax. La subrutina Session_End se ejecuta cuando se llama al método Abandon o
cuando la sesión ha expirado. Una sesión expira cuando el número de minutos especificado por
la propiedad Timeout transcurre sin que se haya creado ninguna solicitud para la sesión.
Puede utilizar el evento Session_End para limpiar la información relacionada con la sesión, como
la información de un usuario de la que el valor SessionID está realizando el seguimiento en un
origen de datos.

Tema 4 / Página 1

Curso .NET con C#
Servicio de Informática

Global.asax

Para manejar estos eventos modificaremos los procedimientos Session_Start y Session_End
del archivo global.asax.
Si queremos crear un nuevo global.asax pincharemos con el botón derecho en el proyecto,
elegiremos Agregar nuevo elemento y de las plantillas instaladas de Visual Studio escogeremos
Clase de Aplicación Global. Se nos creará un nuevo archivo con los procedimientos que manejan
los eventos de sesión y aplicación.
Ejemplo de global.asax que almacena en una variable de aplicación el numero de usuarios
conectados.

<%@ Application Language="C#" %>
<script runat="server">
void Application_Start(object sender, EventArgs e) {
Application["UsersOnline"] = 0;
}

void Session_Start(object sender, EventArgs e) {
Application.Lock();
Application["UsersOnline"] = (int)Application["UsersOnline"] + 1;
Application.UnLock();
}
void Session_End(object sender, EventArgs e) {
Application.Lock();
Application["UsersOnline"] = (int)Application["UsersOnline"] - 1;
Application.UnLock();
}
</script>

Para acceder y modificar las variables de sesión utilizaremos de forma análoga a las de
aplicación la sintaxis: session["variable"]

Archivo de configuración
Podemos almacenar valores para nuestra aplicación web en el fichero web.config. Ahora lo
utilizaremos para almacenar pares clave-valor que serán accesibles desde todos los aspx.
La configuración de la aplicación son pares de nombre y valor que representan el texto de valores
configurables en la aplicación Web. Utilice la configuración de la aplicación para almacenar
información personalizada de configuración de la aplicación, como rutas de acceso a archivos,
direcciones URL de servicios Web XML, texto utilizado con frecuencia o cualquier información
que desee mantener en una ubicación central y que pueda cambiar fácilmente.

Tema 4 / Página 2

Curso .NET con C#
Servicio de Informática

Creación de un valor de configuración

Para ejecutar la Herramienta de Configuración seleccionaremos en el menú Sitio Web la opción
Configuración de ASP.NET. Se nos abrirá el navegador con una página como la de la
ilustración 1.

Ilustración 1: Herramienta de administración de sitios Web

Elegimos la pestaña Aplicación. (Ilustración 2).

Aquí pinchamos la opción Crear configuración de la aplicación dentro del cuadro
Configuración de la Aplicación para agregar una pareja clave-valor o la opción Administrar
configuración de la aplicación para modificar una existente.

Estableceremos los valores para Nombre y Valor y pulsaremos el botón Aceptar. (Ilustración 3)

Tema 4 / Página 3

Curso .NET con C#
Servicio de Informática

Ilustración 2: Herramienta de administración de sitios Web. Aplicación

En nuestro caso hemos creado un para clave valor con miClave = “Hola Sergi”. Nos aparecerá
una ventana de confirmación indicándonos que hemos creado el valor de configuración miClave.

Si queremos ver los valores de configuración creados pulsaremos en Administrar
configuración de la aplicación. Desde aquí también podemos modificar o eliminar los creados
con anterioridad.

Una vez hemos creado los valores que queremos cerramos la Herramienta de Administración de
Sitios Web.

Si abrimos desde Visual Studio el fichero web.config veremos que nos ha creado una nueva
entrada dentro de <appSettings> para nuestra clave.
<appSettings>
<add key="miClave" value="Hola Sergi" />
</appSettings>

Tema 4 / Página 4

Curso .NET con C#
Servicio de Informática

Ilustración 3: Establecer valor de aplicación

Utilización del valor de configuración

Una vez creado el valor, mediante la Herramienta de Administración o modificando el fichero
web.config podemos utilizarla en cualquier aspx de nuestra aplicación.

Para ello utilizaremos la clase ConfigurationManager, que proporciona acceso a los archivos de
configuración. Con el método AppSettings accedemos a la sección appSettings de web.config.

Por ejemplo para sacar por pantalla el valor de nuestra clave escribiremos:
Response.Write (ConfigurationManager.AppSettings["miClave"]);

Si queremos cambiar el valor:
ConfigurationManager.AppSettings["miClave"] = "Hola Juan";
Response.Write("<br/>" + ConfigurationManager.AppSettings["miClave"]);

Tema 4 / Página 5

Curso .NET con C#
Servicio de Informática

Leer el idioma del navegador

Para obtener el idioma que tiene configurado el cliente en su navegador utilizaremos la matriz
UserLanguages del objeto Request. Matriz String que contiene los idiomas especificados en el
encabezado AcceptLanguage de la solicitud o bien null, si la solicitud de cliente no incluía un
encabezado AcceptLanguage

Ejemplo: Si queremos ver todos los idiomas del cliente
// Muestra las preferéncias de lenguaje.
string[] types = Request.UserLanguages;
if (types != null) {
Response.Write("<br />Lenguajes aceptados:");
foreach (string s in types) {
Response.Write(String.Concat("<br/>",s));
}
}

Internacionalización con .NET
.NET y en particular Visual Studio nos ofrecen dos métodos muy sencillos para gestionar la
internacionalización de las aplicaciones, dependiendo del ámbito que queramos traducir:

Internacionalización del formulario de trabajo (etiquetas, botones, etc.)

•
• Textos de avisos o descripciones que pueden aparecer dependiendo de las condiciones

de acceso, de las selecciones que hayan hecho, etc.

Internacionalización del formulario de trabajo
Partiendo que disponemos de un formulario muy sencillo Default.aspx con dos etiquetas, dos
cajas de texto y un botón (Ilustración 4)

Ilustración 4: Formulario sencillo

Vamos a prepararlo para poder gestionar la internacionalización del formulario.
El primer paso es acceder a la pestaña de Código (no se activa la opción de recursos locales
desde la pestaña de Diseño) y acceder al menú Herramientas->Generar recurso local.

En el Explorador de soluciones podremos ver que aparece dentro de App_LocalResources un
nuevo fichero llamado Default.aspx.resx. Este archivo de recursos contendrá los textos de la
aplicación. (Ilustración 5)


Tema 4 / Página 6

Curso .NET con C#
Servicio de Informática

Si abrimos el fichero, veremos algo parecido a lo siguiente (Ilustración 6)

Ilustra