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
- 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