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.