Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C#

RegionInfo — região e código de moeda ISO

RegionInfo em System.Globalization disponibiliza informações sobre um país ou região. A propriedade RegionInfo.ISOCurrencySymbol devolve um código de moeda ISO 4217 de três letras, como USD, e não um símbolo monetário como $.

Versão: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Sintaxe

using System.Globalization;
RegionInfo region = new RegionInfo("en-US");
string currencyCode = region.ISOCurrencySymbol;

RegionInfo, em System.Globalization, descreve um país ou uma região. Não é equivalente a CultureInfo: não representa as preferências do utilizador. A classe está disponível no .NET 10; a utilização apresentada não requer funcionalidades da linguagem em versão prévia.

O construtor new RegionInfo("en-US") aceita o nome de uma cultura específica. Também pode passar um código de região, como "US", mas a documentação recomenda uma cultura específica, porque alguns nomes e símbolos dependem do idioma ou da escrita.

RegionInfo.ISOCurrencySymbol é uma propriedade string só de leitura que devolve um código ISO 4217 de três letras, como USD. Não a confunda com CurrencySymbol, que disponibiliza um símbolo monetário como $, nem com um código de país ISO 3166. O exemplo seleciona explicitamente "en-US", em vez de depender das definições de cultura atuais.

Para dados introduzidos pelo utilizador, tenha em conta os erros do construtor: null provoca ArgumentNullException, enquanto um nome inválido ou uma cultura neutra, como "en", provoca ArgumentException. Um nome de cultura neutra que corresponda a um código de região é interpretado como região. No modo de globalização invariante, se PredefinedCulturesOnly estiver definido como false, o construtor pode aceitar "en-US" e criar o objeto com os dados da cultura invariante. Nesse caso, ISOCurrencySymbol pode devolver um valor diferente de USD. Para produzir o resultado apresentado, o exemplo requer os dados de globalização da região.

Exemplos

using System;
using System.Globalization;

RegionInfo region = new RegionInfo("en-US");
Console.WriteLine(region.ISOCurrencySymbol);

Resultado

USD

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes