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

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