CKTIS / C#
Obter o código de moeda de uma região com RegionInfo.ISOCurrencySymbol
Consulta o código de moeda ISO 4217 de uma região indicada explicitamente e distingue-o do código da região e do símbolo apresentado junto de um montante.
Versão: C# 12 and .NET 8; later runtimes may add compatible features
Sintaxe
public virtual string ISOCurrencySymbol { get; }
// Usage inside a method or in top-level code:
string currencyCode = new System.Globalization.RegionInfo("en-US").ISOCurrencySymbol;RegionInfo, do espaço de nomes System.Globalization, descreve um país ou uma região. ISOCurrencySymbol é uma propriedade de instância pública e virtual sem acessor de escrita. Lê-a sem parênteses: devolve uma string com o código de moeda ISO 4217 de três caracteres associado à região, como USD.
O construtor RegionInfo(string) aceita um código de região como US ou o nome de uma cultura específica como en-US. Ao usares en-US, escolhes a região explicitamente em vez de dependeres das definições regionais atuais. O nome neutro en não identifica uma região e provoca ArgumentException; passar null provoca ArgumentNullException. O modo de globalização invariável pode impedir a criação do objeto. A sobrecarga RegionInfo(int) recebe um identificador de cultura, não um código numérico de moeda.
Para en-US, TwoLetterISORegionName devolve US (código de região), ISOCurrencySymbol devolve USD (código de moeda) e CurrencySymbol devolve $ com as definições padrão. Um símbolo como $ pode representar várias moedas. Guarda o código da moeda efetiva da transação juntamente com o montante: os dados regionais não determinam a moeda da transação nem convertem montantes.
A formatação é uma tarefa distinta. CultureInfo implementa System.IFormatProvider e o seu método GetFormat(Type) disponibiliza objetos como NumberFormatInfo para a formatação de números. amount.ToString("C", culture) aplica as regras de formatação monetária da cultura fornecida; não lê ISOCurrencySymbol nem converte o montante.
Exemplos
using System;
using System.Globalization;
var region = new RegionInfo("en-US");
Console.WriteLine($"Region: {region.TwoLetterISORegionName}");
Console.WriteLine($"Currency code: {region.ISOCurrencySymbol}");
Console.WriteLine($"Display symbol: {region.CurrencySymbol}");Resultado
Region: US Currency code: USD Display symbol: $
O programa lê três propriedades para a cultura `en-US`, escolhida explicitamente. O resultado esperado pressupõe os dados e as definições de globalização padrão para `en-US`, com o modo de globalização invariável desativado.
Lições relacionadas
- C# · Lição 34 · Avançado · Versão: 3
Fontes
- RegionInfo.ISOCurrencySymbol Property (System.Globalization)
- RegionInfo Constructor (System.Globalization)
- RegionInfo.CurrencySymbol Property (System.Globalization)
- RegionInfo.TwoLetterISORegionName Property (System.Globalization)
- IFormatProvider Interface (System)
- Standard numeric format strings
- Runtime configuration options for globalization