Tutorial: localizar una aplicación de negocios

WCF RIA Services

Este tutorial muestra cómo agregar compatibilidad de localización a una aplicación de negocios de WCF RIA Services. Actualmente, muchas aplicaciones de negocios necesitan ser utilizadas por personas en distintas partes del mundo. Silverlight, ASP.NET y WCF RIA Services incluyen compatibilidad con las aplicaciones localizadas para una referencia cultural o configuración regional en particular. En este tutorial, escribirá una aplicación que puede cargar las cadenas de interfaz de usuario escritas en inglés o en francés canadiense, dependiendo del valor de la configuración de idioma en el explorador.

RIA_Walkthrough_Loc_01

En este tutorial se abordan las tareas siguientes:

  • Configurar el proyecto de cliente para admitir idiomas concretos.

  • Localizar los recursos.

  • Configurar la página de prueba para utilizar los recursos localizados.

  • Configurar Internet Explorer para cargar una página localizada.

  • Agregar compatibilidad con idiomas bidireccionales.

Este tutorial y los demás tutoriales presentados en la documentación de WCF RIA Services requieren la instalación y configuración correctas de varios programas de requisitos previos, como Visual Studio 2010 y Silverlight Runtime y SDK, además de WCF RIA Services y el Kit de herramientas de WCF RIA Services. También requieren la instalación y configuración de SQL Server 2008 R2 Express con Advanced Services, así como la instalación de las bases de datos OLTP y LT de AdventureWorks.

Los temas del nodo Requisitos previos para WCF RIA Services proporcionan instrucciones detalladas para el cumplimiento de cada uno de estos requisitos previos. Siga las instrucciones proporcionadas en ellos antes de realizar este tutorial para asegurarse de encontrar el menor número de problemas posibles al trabajar en estos tutoriales de RIA Services .

El procedimiento siguiente muestra cómo especificar los idiomas admitidos en el archivo del proyecto de cliente.

Para configurar el proyecto de cliente

  1. Cree un nuevo proyecto de RIA Services en Visual Studio 2010 seleccionando Archivo, Nuevo y, a continuación, Proyecto.

    Aparece el cuadro de diálogo Nuevo proyecto.

  2. Seleccione la plantilla Aplicación de negocios de Silverlight del grupo Silverlight de las Plantillas instaladas y asigne al nuevo proyecto el nombre LocalizedBusinessApp.

  3. En el Explorador de soluciones, haga clic con el botón secundario en el proyecto de cliente (LocalizedBusinessApp) y, a continuación, haga clic en Descargar el proyecto.

  4. Vuelva a hacer clic con el botón secundario en el proyecto de cliente y, a continuación, haga clic en Editar LocalizedBusinessApp.vbproj o Editar LocalizedBusinessApp.csproj.

    RIA_LBA01_EditProject

    El archivo de proyecto se abre en el diseñador.

  5. Busque el elemento SupportedCultures y agregue el código de referencia cultural para Francés (Canadá) [fr-CA]. Utilice una coma o un punto y coma para delimitar los códigos de referencia cultural.

    <SupportedCultures>en-US,fr-CA</SupportedCultures>
    
  6. Guarde el archivo de proyecto y ciérrelo.

  7. En el Explorador de soluciones, haga clic con el botón secundario en el proyecto de cliente y, a continuación, haga clic en Recargar el proyecto.

    El proyecto se recarga en el Explorador de soluciones.

La operación de agregar compatibilidad a la aplicación con un idioma adicional implica esencialmente la creación de copias de archivos de recursos existentes, el cambio de nombre de los archivos copiados y la traducción de las cadenas en los archivos de recursos que se acaban de copiar. Los procedimientos siguientes muestran cómo localizar los recursos en los proyectos de cliente y de servidor.

Para localizar los recursos del servidor

  1. En el Explorador de soluciones, en el proyecto de servidor (LocalizedBusinessApp.Web), expanda la carpeta Resources.

  2. Haga clic con el botón secundario en el archivo RegistrationDataResources.resx y, a continuación, haga clic en Copiar.

  3. Haga clic con el botón secundario en la carpeta Resources y, a continuación, haga clic en Pegar.

  4. Cambie el nombre de la copia de RegistrationDataResources.resx a RegistrationDataResources.fr-CA.resx.

    noteNota:
    El código de referencia cultural debe estar incluido en el nombre de archivo para establecer correctamente que el recurso pertenece a esa referencia cultural.

  5. De igual forma, copie el archivo ValidationErrorResources.resx y cambie su nombre a ValidationErrorResources.fr-CA.resx.

    RIA_LBA03WebResources
  6. Haga doble clic en RegistrationDataResources.fr-CA.resx para abrirlo en el Diseñador de recursos.

  7. Reemplace los valores y comentarios para inglés por sus equivalentes de francés, como se muestra en la tabla siguiente.

    Las cadenas de la columna Comentario se utilizan normalmente para información sobre herramientas.

     

    Nombre Valor Comentario

    EmailLabel

    E-mail

    FriendlyNameDescription

    Comment voulez-vous que votre nom être affiché dans l'application?

    FriendlyNameLabel

    Nom amical

    PasswordConfirmationLabel

    Confirmer le mot de passe

    PasswordDescription

    Le mot de passe doit être 7 caractères longs et doit contenir au moins un caractère spécial par exemple @ ou #

    Changer ceci si vous changez votre longueur de mot de passe et les politiques de force

    PasswordLabel

    Mot de passe

    SecurityAnswerLabel

    Réponse de sécurité

    SecurityQuestionLabel

    Question de sécurité

    UserNameLabel

    Nom de l'utilisateur

  8. Guarde y cierre el archivo.

    TipSugerencia:
    Este tutorial no localiza todas las cadenas. Para completar la localización correspondiente a los recursos del servidor, debe localizar también ValidationErrorResources.fr-CA.resx.

  9. En el proyecto de cliente, expanda la carpeta Web y, a continuación, expanda Resources.

  10. Haga clic con el botón secundario en la carpeta Resources, haga clic en Agregar y, a continuación, haga clic en Elemento existente.

  11. Navegue hasta la carpeta LocalizedBusinessApp.Web\Resources.

  12. Presione CTRL+clic para seleccionar los archivos siguientes:

    • RegistrationDataResources.fr-CA.resx

    • RegistrationDataResources.fr-CA.Designer.vb (o .cs)

    • ValidationErrorResources.fr-CA.resx

    • ValidationErrorResources.fr-CA.Designer.vb (o .cs)

  13. Haga clic en la flecha abajo en el botón Agregar y, a continuación, haga clic en Agregar como vínculo.

    RIA_LBA04_AddingResxAsLink

    Los archivos localizados se agregan como vínculos en el proyecto de cliente.

Para localizar los recursos del cliente

  1. En el proyecto de cliente, expanda la carpeta Assets y, a continuación, expanda Resources.

  2. Cree una copia de ApplicationStrings.resx y cambie su nombre a ApplicationStrings.fr-CA.resx.

  3. Cree una copia de ErrorResources.resx y cambie su nombre a ErrorResources.fr-CA.resx.

  4. Cree una copia de SecurityQuestions.resx y cambie su nombre a SecurityQuestions.fr-CA.resx.

    RIA_LBA05_ClientResources
  5. Abra ApplicationStrings.fr-CA.resx en el Diseñador de recursos.

  6. Reemplace los valores y comentarios para inglés por sus equivalentes de francés, del modo siguiente:

     

    Nombre Valor Comentario

    AboutPageTitle

    De

     

    AlreadyRegisteredLabel

    Déjà inscrit?

     

    ApplicationName

    Nom d'application

     

    BackToLoginButton

    De retour à la Connexion

     

    BusyIndicatorLoadingUser

    Application d'initialisation. ...

    Ce message est affiché pendant l'initialisation d'application

    BusyIndicatorLoggingIn

    Connecter...

    Affiché pendant LoginOperation

    BusyIndicatorRegisteringUser

    Soumettre Enregistrement...

    Affiché pendant que l'enregistrement est traité par le serveur

    CancelButton

    Annuler

     

    HomePageTitle

    Maison

     

    LoginButton

    connexion

     

    LoginWindowTitle

    Connexion

     

    LogOffButton

    sortie du système

     

    NotRegisteredYetLabel

    Pas inscrit pourtant?

     

    OKButton

    Bien

     

    RegisterNowButton

    Enregistrer maintenant

     

    RegistrationFormHeader

    S'il vous plaît compléter tous les champs obligatoires pour créer votre compte

     

    RegistrationWindowTitle

    Registre

     

    RememberMeLabel

    Garder m'a signé dans

     

    WelcomeMessage

    Accueil {0}

    {0} = User.DisplayName propriété

  7. Guarde y cierre el archivo.

    TipSugerencia:
    Para completar la localización correspondiente a los recursos del cliente, debe localizar también ErrorResources.fr-CA.resx y SecurityQuestions.fr-CA.resx.

El procedimiento siguiente muestra cómo especificar información de referencia cultural en la página de prueba.

Para configurar TestPage.aspx

  1. En el proyecto de servidor, abra LocalizedBusinessAppTestPage.aspx en la vista Código fuente.

  2. En el elemento raíz, agregue los atributos UICulture y Culture que tienen un valor de "auto":

    <%@ Page Language="VB" AutoEventWireup="true" UICulture="auto" Culture="auto" %>
    

    <%@ Page Language="C#" AutoEventWireup="true" UICulture="auto" Culture="auto" %>
    
  3. Guarde el archivo.

La aplicación cliente ya está lista para mostrar cualquiera de sus dos versiones diferentes. Para ver la versión de francés canadiense, debe configurar su explorador web para utilizar francés canadiense como idioma predeterminado. El procedimiento siguiente describe cómo configurar Internet Explorer.

Para configurar Internet Explorer

  1. Presione F5 para ejecutar la solución.

    La aplicación se inicia en Internet Explorer. A menos que la preferencia de idioma en Internet Explorer ya esté establecida en francés canadiense, las cadenas aparecerán en inglés.

  2. Haga clic en el menú Herramientas y, a continuación, en Opciones de Internet.

    Aparecerá el cuadro de diálogo Opciones de Internet.

  3. En la pestaña General, haga clic en Idiomas.

    Aparecerá el cuadro de diálogo Preferencias de idioma.

  4. Haga clic en Agregar.

    Aparecerá el cuadro de diálogo Agregar idioma.

    RIA_LBA06_IE_AddLanguageDialog
  5. Seleccione Francés (Canadá) [fr-CA] y, a continuación, haga clic en Aceptar.

  6. En el cuadro de diálogo Preferencias de idioma, mueva el idioma francés a la parte superior de la lista.

  7. Haga clic dos veces en Aceptar para cerrar los cuadros de diálogo.

  8. Actualice la página.

    Las páginas deben aparecer ahora en francés.

    LBA_fr-CA-Maison_homepage
  9. Haga clic en el vínculo connexion.

    Observe que el cuadro de diálogo Inicio de sesión está en francés.

Para agregar a una aplicación de negocios de Silverlight compatibilidad con un idioma bidireccional, debe seguir los pasos anteriores, sustituyendo el código de configuración regional mostrado para el idioma bidireccional elegido. Además, es necesario especificar la dirección de flujo, como se muestra en el procedimiento siguiente.

Para agregar compatibilidad con idiomas bidireccionales

  1. En cada archivo de recursos que contiene cadenas de idioma bidireccional, agregue una nueva fila con un nombre de FlowDirection y un valor de RightToLeft.

  2. En el elemento raíz de cada ventana XAML en que desee implementar el idioma bidireccional, agregue un atributo FlowDirection.

  3. Enlace el valor de atributo FlowDirection al valor agregado al archivo de recursos, como se muestra en el ejemplo siguiente.

    FlowDirection="{Binding Path=ApplicationStrings.FlowDirection, Source={StaticResource ResourceWrapper}}"
    
Mostrar: