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

CKTIS / C#

RegionInfo — région et code de devise ISO

RegionInfo dans System.Globalization fournit des informations sur un pays ou une région. Sa propriété RegionInfo.ISOCurrencySymbol renvoie un code de devise ISO 4217 à trois lettres, tel que USD, et non un symbole monétaire comme $.

Version : .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Syntaxe

using System.Globalization;
RegionInfo region = new RegionInfo("en-US");
string currencyCode = region.ISOCurrencySymbol;

RegionInfo, dans System.Globalization, décrit un pays ou une région. Cette classe n’est pas équivalente à CultureInfo : elle ne représente pas les préférences de l’utilisateur. Elle est disponible dans .NET 10 ; l’utilisation présentée ne nécessite aucune fonctionnalité du langage en préversion.

Le constructeur new RegionInfo("en-US") accepte le nom d’une culture spécifique. Vous pouvez aussi lui transmettre un code de région tel que "US", mais la documentation recommande une culture spécifique, car certains noms et symboles dépendent de la langue ou de l’écriture.

RegionInfo.ISOCurrencySymbol est une propriété string en lecture seule qui renvoie un code ISO 4217 à trois lettres, tel que USD. Ne la confondez pas avec CurrencySymbol, qui fournit un symbole monétaire tel que $, ni avec un code de pays ISO 3166. L’exemple choisit explicitement "en-US" au lieu de dépendre des paramètres de culture en vigueur.

Pour les données saisies par l’utilisateur, tenez compte des erreurs du constructeur : null provoque ArgumentNullException, tandis qu’un nom non valide ou une culture neutre telle que "en" provoque ArgumentException. Un nom de culture neutre correspondant à un code de région est interprété comme une région. En mode de globalisation invariant, si PredefinedCulturesOnly est défini sur false, le constructeur peut accepter "en-US" et créer l’objet à partir des données de la culture invariante. Dans ce cas, ISOCurrencySymbol peut renvoyer une valeur autre que USD. L’exemple nécessite les données de globalisation de la région pour produire le résultat affiché.

Exemples

using System;
using System.Globalization;

RegionInfo region = new RegionInfo("en-US");
Console.WriteLine(region.ISOCurrencySymbol);

Résultat

USD

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources