Introdução

O ASP.NET MVC, assim como boa parte dos produtos da Microsoft, foi criado em Inglês (Novidade hein), e sendo assim, as vezes nos deparamos com mensagens que para nossos usuários (PT-BR) não são interessantes.

As validações com DataAnnotations são fáceis e simples de utilizar, mas na outra mão, temos suas mensagens de retorno, como “The field {1} is required.” e assim por diante.

Neste post, abordarei algumas soluções para globalizar aplicações ASP.NET MVC sem muito esforço.

Tudo começa no Web.Config

Globalizar uma aplicação na plataforma .NET começa pela adição da TAG Globalization no arquivo de configuração Web.Config.

Esta tag possui conhecidos parâmetros:

  • Culture – Cultura da aplicação (PT, EU, US)
  • uiCulture – Cultura da interface (PT-BR, EU, US)
  • EnableClientBasedCulture - Obtém ou define um valor indicando se as propriedades Culture e UICulture devem se basear no valor do AcceptLanguage, que é enviado pelo cabeçalho do browser.

Esta propriedade deve ser definida entre as tags System.Web no arquivo Web.Config, conforme imagem abaixo.

image

Existem vários tutorias sobre como globalizar aplicações ASP.NET Web Forms, este é um bom exemplo: http://msdn.microsoft.com/en-us/library/bz9tc508.aspx.

Globalizando decimais

Nosso primeiro desafio é globalizar números decimais, que neste caso aceitam somente ponto “.” como casa decimal, e necessitamos de vírgula “,”.

A figura abaixo mostra o erro, onde é exibida uma mensagem mesmo o número estando correto (Para o padrão Brasileiro).

image

Este erro pode ser contornado ao adicionar um JavaScript que extende os validation methods do jQuery, permitindo o uso de vírgula “,” ao invés de ponto “.”.

Infelizmente, o site de plugins do jQuery está fora, impossibilitando o download deste script: http://archive.plugins.jquery.com/node/8/release

Fique à vontade em baixar o arquivo do source no fim deste artigo.

image

Com o arquivo “methods_pt.js” incluso na pasta Scripts da aplicação, é só fazer referência ao mesmo sempre que utilizar o jQuery Unnobstrutive, como nas páginas Create e Edit.

image

Deste modo, já podemos utilizar decimais “abrasileirados”.

image

Mas ainda temos o problema da mensagem em inglês, caso um valor com “.” seja digitado.

image

Infelizmente, a única forma que encontrei para resolver este problema, foi mediante um regular expression, que só permite números.

image

Deste modo, agora temos a mensagem agora está em portugês, como definida nas anotações da propriedade.

image

Pronto, decimais globalizados!

Utilizando Resources com DataAnnotations

Em alguns casos, você pode querer utilizar os bones e velhos Resources, que são arquivos onde mapeamos mensagens a serem substituidas em tempo de execução, justamente para globalização de aplicações.

Para este exemplo criei um arquivo chamado DataAnnotations.resx na pasta App_GlobalResources da aplicação, e nele adicionei duas strings.

image

A primeira chave, o “LidoDoResource” é uma palavra não reservada, que utilizarei para leitura nas anotações.

Já a palavra PropertyValueInvalid é uma palavra reservada, que toda vez que um valor inválido, para uma data por exemplo, for inserido, esta mensagem será retornada.

Então, no arquivo Global.asax, definimos um binder para que as requisições utilizem o Resource que criamos.

image

Para utilizar os resources criados nas anotações, basta utilizar as propriedades ErrorMessageResourceName e ErrorMessageResourceType.

image

O resultado é que agora ele lê a mensagem direto do Resource.

imageimage

No caso do resource PropertyValueInvalid, este processo ocorre automaticamente.

image

image

Conclusão

Globalizar aplicações sempre desprenderá um esforço extra, porém temos alguns meios de minimizar isto, como mostrado neste post.

A questão dos decimais no ASP.NET MVC também é algo que irrita um pouco, mas como vimos pode ser facilmente contornado com um JavaScript.

Downloads

http://files.insidedotnet.com.br/IE7Tests.zip

Referências

Using MVC 3 with non-English Locales
http://blogs.msdn.com/b/rickandy/archive/2011/02/17/using-mvc-3-with-non-english-locales.aspx

How to: Set the Culture and UI Culture for ASP.NET Web Page Globalization
http://msdn.microsoft.com/en-us/library/bz9tc508.aspx

André Baltieri
MTAC - Microsoft Technical Audience Contributor
MSN:
andrebaltieri@hotmail.com | Twitter:
@andrebaltieri
Blog: http://andrebaltieri.wordpress.com

Inside .NET Users Group Leader
http://www.insidedotnet.com.br/