Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C#

Obtenir le code de devise d’une région avec RegionInfo.ISOCurrencySymbol

Récupérez le code de devise ISO 4217 d’une région explicite et distinguez-le du code de région et du symbole affiché à côté d’un montant.

Version : C# 12 and .NET 8; later runtimes may add compatible features

Syntaxe

public virtual string ISOCurrencySymbol { get; }

// Usage inside a method or in top-level code:
string currencyCode = new System.Globalization.RegionInfo("en-US").ISOCurrencySymbol;

RegionInfo, dans l’espace de noms System.Globalization, décrit un pays ou une région. Sa propriété d’instance ISOCurrencySymbol est publique, virtuelle et dépourvue d’accesseur d’écriture. Lisez-la sans parenthèses : elle renvoie une valeur string contenant le code de devise ISO 4217 à trois caractères associé à la région, par exemple USD.

Le constructeur RegionInfo(string) accepte un code de région comme US ou le nom d’une culture spécifique comme en-US. Avec en-US, vous sélectionnez explicitement la région au lieu de dépendre des paramètres régionaux actuels. Le nom neutre en ne désigne aucune région et provoque une ArgumentException ; null provoque une ArgumentNullException. Le mode de globalisation invariant peut empêcher la création de l’objet. La surcharge distincte RegionInfo(int) attend un identifiant de culture, pas un code numérique de devise.

Pour en-US, TwoLetterISORegionName renvoie US (code de région), ISOCurrencySymbol renvoie USD (code de devise) et CurrencySymbol renvoie $ avec les paramètres standard. Un symbole tel que $ peut représenter plusieurs devises. Enregistrez le code de devise réel de la transaction avec son montant : les données régionales ne déterminent pas la devise de la transaction et ne convertissent pas les montants.

La mise en forme est une opération distincte. CultureInfo implémente System.IFormatProvider et sa méthode GetFormat(Type) fournit notamment NumberFormatInfo pour la mise en forme numérique. amount.ToString("C", culture) applique les règles de mise en forme monétaire de la culture fournie, sans lire ISOCurrencySymbol ni convertir le montant.

Exemples

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}");

Résultat

Region: US
Currency code: USD
Display symbol: $

Le programme lit trois propriétés de la culture `en-US`, sélectionnée explicitement. Le résultat attendu suppose les données et paramètres de globalisation standard pour `en-US` et un mode de globalisation invariant désactivé.

Leçons associées

  • C# · Leçon 34 · Avancé · Version : 3

Sources