Web.config - A import�ncia de se configurar a cultura

Durante o desenvolvimento de aplicaç�es voltadas � Internet (ou at� mesmo com soluç�es concebidas para uma rede interna em uma organizaç�o) � bastante comum a exist�ncia de instruç�es convertendo datas e/ou valor financeiros, al�m da necessidade de exibiç�o de tais valores em tela (em se tratando de um site). Embora muitos programadores partam da premissa que o ambiente em que uma aplicaç�o ficar� hospedada para uso definitivo estar� devidamente configurada, contando para isto com as mesmas definiç�es que existiam no ambiente de desenvolvimento, isto muitas vezes acaba por n�o acontecer na pr�tica.

Os motivos em tais casos s�o os mais diversos: a utilizaç�o de servidores de hospedagem que se encontram em outros pa�ses (e que, portanto, podem estar com configuraç�es regionais seguindo padr�es diferentes daqueles esperados por usu�rios da aplicaç�o), m�quinas que funcionam como servidor e que n�o tiveram suas configuraç�es ajustadas para um determinado padr�o regional ou ainda, uma falta de atenç�o da parte dos envolvidos na implementaç�o em definir explicitamente o padr�o a ser empregado para datas e valores num�ricos.

Supondo um cen�rio em que uma aplicaç�o Web (site em ASP.NET ou serviço WCF) acessa informaç�es que constam em arquivos XML, � bem prov�vel que a soluç�o implementada manipule informaç�es como datas e valores monet�rios. Em ou mais pontos dos componentes que foram codificados, poder�o ocorrer uma s�rie de convers�es, como strings sendo transformadas para o equivalente em tipos como DateTime e decimal. A Listagem 1 ilustra um exemplo disto.

Listagem 1: Exemplo de convers�o de data que pode resultar em erro



...

private void ProcessarInformacoes()
{
    string dataSolicitacao; // Vari�vel a ser preenchida posteriomente


    // Outras instruç�es para manipulaç�o de informaç�es
    // de um arquivo XML
    ...


    // Converte a data obtida a partir de um arquivo XML
    DateTime data = Convert.ToDateTime(dataSolicitacao);
}

...

Considerando que o m�todo apresentado na Listagem 1 tenha sido testado pelo desenvolvedor em um computador seguindo os padr�es de configuraç�es regionais do Brasil, existir� a probabilidade de erros quando a aplicaç�o for implantada, uma vez que o formato de data n�o foi especificado na instruç�o que realizada a convers�o. Se o servidor que hospedar� a soluç�o estiver configurado para o padr�o norte-americano, uma p�gina Web que dependa de maneira direta ou n�o da operaç�o ProcessarInformacoes poder�, dessa forma, gerar um erro similar �quele demonstrado na Figura 1 (levando em conta para isto a tentativa de se converter a string �25/12/2011� para uma data equivalente, segundo o formato utilizado no Brasil).

Figura 1: Erro de convers�o em uma p�gina ASP.NET Web Forms

Uma maneira de se solucionar este tipo de problema sem alteraç�es no c�digo-fonte consiste, basicamente, em definir a cultura no arquivo Web.config. Dentro deste �ltimo faz-se necess�rio ent�o declarar o elemento �globalization�, especificando no atributo �culture� o valor �pt-BR� (o qual indica que as configuraç�es regionais do Brasil ser�o adotadas). A Listagem 2 apresenta um exemplo disto.

Listagem 2: Configurando o elemento globalization no Web.config



<?xml version="1.0"?>
<configuration>

  ...

  <system.web>

    ...

    <globalization culture="pt-BR" ... />

    ...

  </system.web>

  ...

</configuration>

Com este ajuste no Web.config evitam-se, assim, erros de convers�o de datas (como aquele da Figura 1) e valores num�ricos. Existem outras formas de se resolver este tipo de problema, por�m a maneira aqui discutida pode ser empregada sem maiores dificuldades, facilitando a configuraç�o de sites e Web Services nos quais n�o h� a necessidade de se tratarem formatos de diferentes pa�ses. Espero que este artigo possa ser �til no seu dia-a-dia. At� uma pr�xima oportunidade!

Web.config - A import�ncia de se configurar a cultura

Artigos relacionados