From 0d23c1f96815f651a44e8f81fdf0c5c865d473a2 Mon Sep 17 00:00:00 2001 From: Genevieve Warren <24882762+gewarren@users.noreply.github.com> Date: Sat, 31 Jan 2026 18:37:37 -0800 Subject: [PATCH 1/2] change bulgaria currency unit --- xml/System.Globalization/RegionInfo.xml | 424 ++++++++++++------------ 1 file changed, 211 insertions(+), 213 deletions(-) diff --git a/xml/System.Globalization/RegionInfo.xml b/xml/System.Globalization/RegionInfo.xml index 3751eda2c0f..607380ff85b 100644 --- a/xml/System.Globalization/RegionInfo.xml +++ b/xml/System.Globalization/RegionInfo.xml @@ -152,18 +152,18 @@ is the recommended constructor for instantiating a object. Unlike the constructor that requires a numeric culture identifier as a parameter, its parameter is a more readable culture name or country code. + is the recommended constructor for instantiating a object. Unlike the constructor that requires a numeric culture identifier as a parameter, its parameter is a more readable culture name or country code. - The culture identifier is mapped to the corresponding National Language Support (NLS) locale identifier. For more information, see [Windows LCID reference](/openspecs/windows_protocols/ms-lcid/a9eac961-e77d-41a6-90a5-ce1a8b0cdb9c). +The culture identifier is mapped to the corresponding National Language Support (NLS) locale identifier. For more information, see [Windows LCID reference](/openspecs/windows_protocols/ms-lcid/a9eac961-e77d-41a6-90a5-ce1a8b0cdb9c). - The value of the property of the new object instantiated by calling this constructor is the ISO 3166 2-letter code for the country/region, not the combined language and country/region code. For example, if a object is instantiated with the culture identifier 0x0409 for the English (United States) culture, the value of the property is "US". In contrast, if a object is instantiated with the combined language and country/region code `en-US` for the English (United States) culture, the value of the property is "en-US" in .NET Framework and just "US" in .NET Core and .NET 5+. +The value of the property of the new object instantiated by calling this constructor is the ISO 3166 2-letter code for the country/region, not the combined language and country/region code. For example, if a object is instantiated with the culture identifier 0x0409 for the English (United States) culture, the value of the property is "US". In contrast, if a object is instantiated with the combined language and country/region code `en-US` for the English (United States) culture, the value of the property is "en-US" in .NET Framework and just "US" in .NET Core and .NET 5+. ## Examples - The following code example compares two instances of that were created differently. - :::code language="csharp" source="~/snippets/csharp/System.Globalization/RegionInfo/.ctor/regioninfo_equals.cs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/System.Globalization/RegionInfo/.ctor/regioninfo_equals.vb" id="Snippet1"::: +The following code example compares two instances of that were created differently. + +:::code language="csharp" source="~/snippets/csharp/System.Globalization/RegionInfo/.ctor/regioninfo_equals.cs" id="Snippet1"::: +:::code language="vb" source="~/snippets/visualbasic/System.Globalization/RegionInfo/.ctor/regioninfo_equals.vb" id="Snippet1"::: ]]> @@ -232,20 +232,20 @@ , , and properties return the specified code or culture name in uppercase. +The `name` parameter is either one of the codes defined for country/region, or a specific, custom, or Windows-only culture name. Case is not significant. However, the , , and properties return the specified code or culture name in uppercase. - The predefined names are listed in [ISO 3166: Country codes](https://www.iso.org/iso-3166-country-codes.html). +The predefined names are listed in [ISO 3166: Country codes](https://www.iso.org/iso-3166-country-codes.html). - You should provide the name of a specific culture rather than just a country/region name in the `name` parameter. For example, `en-US` for English (United States) or `es-US` for Spanish (United States) is preferable to `US` because properties such as and reflect a specific language. `az-Latn-AZ` or `az-Cyrl-AZ` is preferable to `AZ` because properties such as , , and reflect a specific script. The predefined culture names are listed at [Windows LCID reference](/openspecs/windows_protocols/ms-lcid/a9eac961-e77d-41a6-90a5-ce1a8b0cdb9c). +You should provide the name of a specific culture rather than just a country/region name in the `name` parameter. For example, `en-US` for English (United States) or `es-US` for Spanish (United States) is preferable to `US` because properties such as and reflect a specific language. `az-Latn-AZ` or `az-Cyrl-AZ` is preferable to `AZ` because properties such as , , and reflect a specific script. The predefined culture names are listed at [Windows LCID reference](/openspecs/windows_protocols/ms-lcid/a9eac961-e77d-41a6-90a5-ce1a8b0cdb9c). This constructor throws an if `name` is a neutral culture (such as `en` for English). ## Examples - The following code example compares two instances of that were created differently. - :::code language="csharp" source="~/snippets/csharp/System.Globalization/RegionInfo/.ctor/regioninfo_equals.cs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/System.Globalization/RegionInfo/.ctor/regioninfo_equals.vb" id="Snippet1"::: +The following code example compares two instances of that were created differently. + +:::code language="csharp" source="~/snippets/csharp/System.Globalization/RegionInfo/.ctor/regioninfo_equals.cs" id="Snippet1"::: +:::code language="vb" source="~/snippets/visualbasic/System.Globalization/RegionInfo/.ctor/regioninfo_equals.vb" id="Snippet1"::: The following code example creates instances of using culture names. @@ -321,10 +321,11 @@ This constructor throws an if `name` is a neutra property. - :::code language="csharp" source="~/snippets/csharp/System.Globalization/RegionInfo/CurrencyEnglishName/rgn5props.cs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/System.Globalization/RegionInfo/CurrencyEnglishName/rgn5props.vb" id="Snippet1"::: +The following code example demonstrates the property. + +:::code language="csharp" source="~/snippets/csharp/System.Globalization/RegionInfo/CurrencyEnglishName/rgn5props.cs" id="Snippet1"::: +:::code language="vb" source="~/snippets/visualbasic/System.Globalization/RegionInfo/CurrencyEnglishName/rgn5props.vb" id="Snippet1"::: ]]> @@ -383,16 +384,16 @@ This constructor throws an if `name` is a neutra object is created with a specific culture and more than one language is used in the corresponding country/region, the property retrieves the currency name associated with the specific culture. +If the current object is created with a specific culture and more than one language is used in the corresponding country/region, the property retrieves the currency name associated with the specific culture. - The value of this property depends on the language that's associated with a particular country/region. Therefore, if you intend to use the property, you should instantiate the object by passing the constructor a combined language and country/region code. For example, if a object is instantiated with a combined language and country/region code of "en-CA" for English (Canada), the value of its property is "Canadian Dollar". If it is instantiated with a combined language and country/region code of "fr-CA" for French (Canada), the value of its property is "Dollar canadien". Therefore, creating the `RegionInfo` object with only a country/region name ("CA" in this case) is not specific enough to distinguish the appropriate native currency name. +The value of this property depends on the language that's associated with a particular country/region. Therefore, if you intend to use the property, you should instantiate the object by passing the constructor a combined language and country/region code. For example, if a object is instantiated with a combined language and country/region code of "en-CA" for English (Canada), the value of its property is "Canadian Dollar". If it is instantiated with a combined language and country/region code of "fr-CA" for French (Canada), the value of its property is "Dollar canadien". Therefore, creating the `RegionInfo` object with only a country/region name ("CA" in this case) is not specific enough to distinguish the appropriate native currency name. ## Examples - The following code example demonstrates the property. - :::code language="csharp" source="~/snippets/csharp/System.Globalization/RegionInfo/CurrencyEnglishName/rgn5props.cs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/System.Globalization/RegionInfo/CurrencyEnglishName/rgn5props.vb" id="Snippet1"::: +The following code example demonstrates the property. + +:::code language="csharp" source="~/snippets/csharp/System.Globalization/RegionInfo/CurrencyEnglishName/rgn5props.cs" id="Snippet1"::: +:::code language="vb" source="~/snippets/visualbasic/System.Globalization/RegionInfo/CurrencyEnglishName/rgn5props.vb" id="Snippet1"::: ]]> @@ -450,16 +451,16 @@ This constructor throws an if `name` is a neutra object is created with a specific culture and more than one language is used in the corresponding country/region, the property returns the currency symbol associated with the specific culture. +If the current object is created with a specific culture and more than one language is used in the corresponding country/region, the property returns the currency symbol associated with the specific culture. ## Examples - The following code example displays the properties of the class. - :::code language="csharp" source="~/snippets/csharp/System.Globalization/RegionInfo/CurrencySymbol/regioninfo_properties.cs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/System.Globalization/RegionInfo/CurrencySymbol/regioninfo_properties.vb" id="Snippet1"::: +The following code example displays the properties of the class. + +:::code language="csharp" source="~/snippets/csharp/System.Globalization/RegionInfo/CurrencySymbol/regioninfo_properties.cs" id="Snippet1"::: +:::code language="vb" source="~/snippets/visualbasic/System.Globalization/RegionInfo/CurrencySymbol/regioninfo_properties.vb" id="Snippet1"::: ]]> @@ -518,8 +519,7 @@ This constructor throws an if `name` is a neutra . The class does not automatically detect changes in the system settings, but the property is updated when you call the method. +The value of this property is based on the culture selected through the regional and language options portion of Control Panel. However, that information can change during the life of the . The class does not automatically detect changes in the system settings, but the property is updated when you call the method. ]]> @@ -577,16 +577,16 @@ This constructor throws an if `name` is a neutra property displays the country/region name in the language of the localized version of .NET. For example, the property displays the country/region in English on the English version of .NET, and in Spanish on the Spanish version of .NET. +The property displays the country/region name in the language of the localized version of .NET. For example, the property displays the country/region in English on the English version of .NET, and in Spanish on the Spanish version of .NET. - The value of the property is taken from the resource files in the language of the current user interface culture, represented by . Custom regions or those synthesized from the operating system might not have resource information, in which case the value for is the same as the value of the property. +The value of the property is taken from the resource files in the language of the current user interface culture, represented by . Custom regions or those synthesized from the operating system might not have resource information, in which case the value for is the same as the value of the property. ## Examples - The following code example displays the properties of the class. - :::code language="csharp" source="~/snippets/csharp/System.Globalization/RegionInfo/CurrencySymbol/regioninfo_properties.cs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/System.Globalization/RegionInfo/CurrencySymbol/regioninfo_properties.vb" id="Snippet1"::: +The following code example displays the properties of the class. + +:::code language="csharp" source="~/snippets/csharp/System.Globalization/RegionInfo/CurrencySymbol/regioninfo_properties.cs" id="Snippet1"::: +:::code language="vb" source="~/snippets/visualbasic/System.Globalization/RegionInfo/CurrencySymbol/regioninfo_properties.vb" id="Snippet1"::: ]]> @@ -649,14 +649,14 @@ This constructor throws an if `name` is a neutra object created for the English (United States) culture displays "United States". +For example, a object created for the English (United States) culture displays "United States". ## Examples - The following code example displays the properties of the class. - :::code language="csharp" source="~/snippets/csharp/System.Globalization/RegionInfo/CurrencySymbol/regioninfo_properties.cs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/System.Globalization/RegionInfo/CurrencySymbol/regioninfo_properties.vb" id="Snippet1"::: +The following code example displays the properties of the class. + +:::code language="csharp" source="~/snippets/csharp/System.Globalization/RegionInfo/CurrencySymbol/regioninfo_properties.cs" id="Snippet1"::: +:::code language="vb" source="~/snippets/visualbasic/System.Globalization/RegionInfo/CurrencySymbol/regioninfo_properties.vb" id="Snippet1"::: ]]> @@ -726,14 +726,14 @@ This constructor throws an if `name` is a neutra . +This method overrides . ## Examples - The following code example compares two instances of that were created differently. - :::code language="csharp" source="~/snippets/csharp/System.Globalization/RegionInfo/.ctor/regioninfo_equals.cs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/System.Globalization/RegionInfo/.ctor/regioninfo_equals.vb" id="Snippet1"::: +The following code example compares two instances of that were created differently. + +:::code language="csharp" source="~/snippets/csharp/System.Globalization/RegionInfo/.ctor/regioninfo_equals.cs" id="Snippet1"::: +:::code language="vb" source="~/snippets/visualbasic/System.Globalization/RegionInfo/.ctor/regioninfo_equals.vb" id="Snippet1"::: ]]> @@ -789,16 +789,16 @@ This constructor throws an if `name` is a neutra property to provide culture-specific services to customers. For example, the property can be used as a key to access a database record that contains specific information about a country/region. +The application should use the property to provide culture-specific services to customers. For example, the property can be used as a key to access a database record that contains specific information about a country/region. - This property value corresponds to the Windows `GetUserGeoID` function. For a list of geographical identifiers, see [Table of Geographical Locations](/windows/win32/intl/table-of-geographical-locations). +This property value corresponds to the Windows `GetUserGeoID` function. For a list of geographical identifiers, see [Table of Geographical Locations](/windows/win32/intl/table-of-geographical-locations). ## Examples - The following code example demonstrates the property. - :::code language="csharp" source="~/snippets/csharp/System.Globalization/RegionInfo/CurrencyEnglishName/rgn5props.cs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/System.Globalization/RegionInfo/CurrencyEnglishName/rgn5props.vb" id="Snippet1"::: +The following code example demonstrates the property. + +:::code language="csharp" source="~/snippets/csharp/System.Globalization/RegionInfo/CurrencyEnglishName/rgn5props.cs" id="Snippet1"::: +:::code language="vb" source="~/snippets/visualbasic/System.Globalization/RegionInfo/CurrencyEnglishName/rgn5props.vb" id="Snippet1"::: ]]> @@ -851,10 +851,9 @@ This constructor throws an if `name` is a neutra . +This method overrides . - This method generates the same hash code for two objects that are equal according to the method. +This method generates the same hash code for two objects that are equal according to the method. ]]> @@ -917,10 +916,11 @@ This constructor throws an if `name` is a neutra class. - :::code language="csharp" source="~/snippets/csharp/System.Globalization/RegionInfo/CurrencySymbol/regioninfo_properties.cs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/System.Globalization/RegionInfo/CurrencySymbol/regioninfo_properties.vb" id="Snippet1"::: +The following code example displays the properties of the class. + +:::code language="csharp" source="~/snippets/csharp/System.Globalization/RegionInfo/CurrencySymbol/regioninfo_properties.cs" id="Snippet1"::: +:::code language="vb" source="~/snippets/visualbasic/System.Globalization/RegionInfo/CurrencySymbol/regioninfo_properties.vb" id="Snippet1"::: ]]> @@ -978,128 +978,128 @@ This constructor throws an if `name` is a neutra property. - -|Country/region|Currency name|ISO 4217 currency symbol| -|---------------------|-------------------|------------------------------| -|Albania|Albanian Lek|ALL| -|Algeria|Algerian Dinar|DZD| -|Argentina|Argentine Peso|ARS| -|Armenia|Armenian Dram|AMD| -|Australia|Australian Dollar|AUD| -|Austria|Euro|EUR| -|Azerbaijan|Azerbaijanian Manat|AZN| -|Bahrain|Bahraini Dinar|BHD| -|Belarus|Belarussian Ruble|BYR| -|Belgium|Euro|EUR| -|Belize|Belize Dollar|BZD| -|Bolivarian Republic of Venezuela|Venezuelan Bolivar|VEF| -|Bolivia|Boliviano|BOB| -|Brazil|Real|BRL| -|Brunei|Brunei Dollar|BND| -|Bulgaria|Bulgarian Lev|BGN| -|Canada|Canadian Dollar|CAD| -|Caribbean|US Dollar|USD| -|Chile|Chilean Peso|CLP| -|Colombia|Colombian Peso|COP| -|Costa Rica|Costa Rican Colon|CRC| -|Croatia|Croatian Kuna|HRK| -|Czech Republic|Czech Koruna|CZK| -|Denmark|Danish Krone|DKK| -|Dominican Republic|Dominican Peso|DOP| -|Ecuador|US Dollar|USD| -|Egypt|Egyptian Pound|EGP| -|El Salvador|U.S. Dollar|USD| -|Estonia|Estonian Kroon|EEK| -|Ethiopia|Ethiopian Birr|ETB| -|Faroe Islands|Danish Krone|DKK| -|Finland|Euro|EUR| -|France|Euro|EUR| -|Georgia|Lari|GEL| -|Germany|Euro|EUR| -|Greece|Euro|EUR| -|Guatemala|Guatemalan Quetzal|GTQ| -|Honduras|Honduran Lempira|HNL| -|Hong Kong SAR|Hong Kong Dollar|HKD| -|Hungary|Hungarian Forint|HUF| -|Iceland|Icelandic Krona|ISK| -|India|Indian Rupee|INR| -|Indonesia|Indonesian Rupiah|IDR| -|Iran|Iranian Rial|IRR| -|Iraq|Iraqi Dinar|IQD| -|Ireland|Euro|EUR| -|Islamic Republic of Pakistan|Pakistan Rupee|PKR| -|Israel|Israeli New Shekel|ILS| -|Italy|Euro|EUR| -|Jamaica|Jamaican Dollar|JMD| -|Japan|Japanese Yen|JPY| -|Jordan|Jordanian Dinar|JOD| -|Kazakhstan|Tenge|KZT| -|Kenya|Kenyan Shilling|KES| -|Korea|Korean Won|KRW| -|Kuwait|Kuwaiti Dinar|KWD| -|Kyrgyzstan|som|KGS| -|Latvia|Latvian Lats|LVL| -|Lebanon|Lebanese Pound|LBP| -|Libya|Libyan Dinar|LYD| -|Liechtenstein|Swiss Franc|CHF| -|Lithuania|Lithuanian Litas|LTL| -|Luxembourg|Euro|EUR| -|Macao SAR|Macao Pataca|MOP| -|North Macedonia|Macedonian Denar|MKD| -|Malaysia|Malaysian Ringgit|MYR| -|Maldives|Rufiyaa|MVR| -|Mexico|Mexican Peso|MXN| -|Mongolia|Tugrik|MNT| -|Morocco|Moroccan Dirham|MAD| -|Netherlands|Euro|EUR| -|New Zealand|New Zealand Dollar|NZD| -|Nicaragua|Nicaraguan Cordoba Oro|NIO| -|Norway|Norwegian Krone|NOK| -|Oman|Omani Rial|OMR| -|Panama|Panamanian Balboa|PAB| -|Paraguay|Paraguay Guarani|PYG| -|People's Republic of China|PRC Renminbi|CNY| -|Peru|Peruvian Nuevo Sol|PEN| -|Philippines|Philippine Peso|PHP| -|Poland|Polish Zloty|PLN| -|Portugal|Euro|EUR| -|Principality of Monaco|Euro|EUR| -|Puerto Rico|US Dollar|USD| -|Qatar|Qatari Rial|QAR| -|Romania|Romanian Leu|RON| -|Russia|Russian Ruble|RUB| -|Saudi Arabia|Saudi Riyal|SAR| -|Serbia|Serbian Dinar|RSD| -|Singapore|Singapore Dollar|SGD| -|Slovakia|Euro|EUR| -|Slovenia|Euro|EUR| -|South Africa|South African Rand|ZAR| -|Spain|Euro|EUR| -|Sweden|Swedish Krona|SEK| -|Switzerland|Swiss Franc|CHF| -|Syria|Syrian Pound|SYP| -|Taiwan|New Taiwan Dollar|TWD| -|Thailand|Thai Baht|THB| -|Trinidad and Tobago|Trinidad Dollar|TTD| -|Tunisia|Tunisian Dinar|TND| -|Turkey|Turkish Lira|TRY| -|Ukraine|Ukrainian Hryvnia|UAH| -|United Arab Emirates|UAE Dirham|AED| -|United Kingdom|UK Pound Sterling|GBP| -|United States|US Dollar|USD| -|Uruguay|Peso Uruguayo|UYU| -|Uzbekistan|Uzbekistan Som|UZS| -|Vietnam|Vietnamese Dong|VND| -|Yemen|Yemeni Rial|YER| -|Zimbabwe|Zimbabwe Dollar|ZWL| +The following example lists some of the [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html) currency symbols returned by the property. + +| Country/region | Currency name | ISO 4217 currency symbol | +| -------------------------------- | ---------------------- | ------------------------ | +| Albania | Albanian Lek | ALL | +| Algeria | Algerian Dinar | DZD | +| Argentina | Argentine Peso | ARS | +| Armenia | Armenian Dram | AMD | +| Australia | Australian Dollar | AUD | +| Austria | Euro | EUR | +| Azerbaijan | Azerbaijanian Manat | AZN | +| Bahrain | Bahraini Dinar | BHD | +| Belarus | Belarussian Ruble | BYR | +| Belgium | Euro | EUR | +| Belize | Belize Dollar | BZD | +| Bolivarian Republic of Venezuela | Venezuelan Bolivar | VEF | +| Bolivia | Boliviano | BOB | +| Brazil | Real | BRL | +| Brunei | Brunei Dollar | BND | +| Bulgaria | Euro | EUR | +| Canada | Canadian Dollar | CAD | +| Caribbean | US Dollar | USD | +| Chile | Chilean Peso | CLP | +| Colombia | Colombian Peso | COP | +| Costa Rica | Costa Rican Colon | CRC | +| Croatia | Croatian Kuna | HRK | +| Czech Republic | Czech Koruna | CZK | +| Denmark | Danish Krone | DKK | +| Dominican Republic | Dominican Peso | DOP | +| Ecuador | US Dollar | USD | +| Egypt | Egyptian Pound | EGP | +| El Salvador | U.S. Dollar | USD | +| Estonia | Estonian Kroon | EEK | +| Ethiopia | Ethiopian Birr | ETB | +| Faroe Islands | Danish Krone | DKK | +| Finland | Euro | EUR | +| France | Euro | EUR | +| Georgia | Lari | GEL | +| Germany | Euro | EUR | +| Greece | Euro | EUR | +| Guatemala | Guatemalan Quetzal | GTQ | +| Honduras | Honduran Lempira | HNL | +| Hong Kong SAR | Hong Kong Dollar | HKD | +| Hungary | Hungarian Forint | HUF | +| Iceland | Icelandic Krona | ISK | +| India | Indian Rupee | INR | +| Indonesia | Indonesian Rupiah | IDR | +| Iran | Iranian Rial | IRR | +| Iraq | Iraqi Dinar | IQD | +| Ireland | Euro | EUR | +| Islamic Republic of Pakistan | Pakistan Rupee | PKR | +| Israel | Israeli New Shekel | ILS | +| Italy | Euro | EUR | +| Jamaica | Jamaican Dollar | JMD | +| Japan | Japanese Yen | JPY | +| Jordan | Jordanian Dinar | JOD | +| Kazakhstan | Tenge | KZT | +| Kenya | Kenyan Shilling | KES | +| Korea | Korean Won | KRW | +| Kuwait | Kuwaiti Dinar | KWD | +| Kyrgyzstan | som | KGS | +| Latvia | Latvian Lats | LVL | +| Lebanon | Lebanese Pound | LBP | +| Libya | Libyan Dinar | LYD | +| Liechtenstein | Swiss Franc | CHF | +| Lithuania | Lithuanian Litas | LTL | +| Luxembourg | Euro | EUR | +| Macao SAR | Macao Pataca | MOP | +| North Macedonia | Macedonian Denar | MKD | +| Malaysia | Malaysian Ringgit | MYR | +| Maldives | Rufiyaa | MVR | +| Mexico | Mexican Peso | MXN | +| Mongolia | Tugrik | MNT | +| Morocco | Moroccan Dirham | MAD | +| Netherlands | Euro | EUR | +| New Zealand | New Zealand Dollar | NZD | +| Nicaragua | Nicaraguan Cordoba Oro | NIO | +| Norway | Norwegian Krone | NOK | +| Oman | Omani Rial | OMR | +| Panama | Panamanian Balboa | PAB | +| Paraguay | Paraguay Guarani | PYG | +| People's Republic of China | PRC Renminbi | CNY | +| Peru | Peruvian Nuevo Sol | PEN | +| Philippines | Philippine Peso | PHP | +| Poland | Polish Zloty | PLN | +| Portugal | Euro | EUR | +| Principality of Monaco | Euro | EUR | +| Puerto Rico | US Dollar | USD | +| Qatar | Qatari Rial | QAR | +| Romania | Romanian Leu | RON | +| Russia | Russian Ruble | RUB | +| Saudi Arabia | Saudi Riyal | SAR | +| Serbia | Serbian Dinar | RSD | +| Singapore | Singapore Dollar | SGD | +| Slovakia | Euro | EUR | +| Slovenia | Euro | EUR | +| South Africa | South African Rand | ZAR | +| Spain | Euro | EUR | +| Sweden | Swedish Krona | SEK | +| Switzerland | Swiss Franc | CHF | +| Syria | Syrian Pound | SYP | +| Taiwan | New Taiwan Dollar | TWD | +| Thailand | Thai Baht | THB | +| Trinidad and Tobago | Trinidad Dollar | TTD | +| Tunisia | Tunisian Dinar | TND | +| Turkey | Turkish Lira | TRY | +| Ukraine | Ukrainian Hryvnia | UAH | +| United Arab Emirates | UAE Dirham | AED | +| United Kingdom | UK Pound Sterling | GBP | +| United States | US Dollar | USD | +| Uruguay | Peso Uruguayo | UYU | +| Uzbekistan | Uzbekistan Som | UZS | +| Vietnam | Vietnamese Dong | VND | +| Yemen | Yemeni Rial | YER | +| Zimbabwe | Zimbabwe Dollar | ZWL | ## Examples - The following code example displays the properties of the class. - :::code language="csharp" source="~/snippets/csharp/System.Globalization/RegionInfo/CurrencySymbol/regioninfo_properties.cs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/System.Globalization/RegionInfo/CurrencySymbol/regioninfo_properties.vb" id="Snippet1"::: +The following code example displays the properties of the class. + +:::code language="csharp" source="~/snippets/csharp/System.Globalization/RegionInfo/CurrencySymbol/regioninfo_properties.cs" id="Snippet1"::: +:::code language="vb" source="~/snippets/visualbasic/System.Globalization/RegionInfo/CurrencySymbol/regioninfo_properties.vb" id="Snippet1"::: ]]> @@ -1156,16 +1156,16 @@ This constructor throws an if `name` is a neutra object is created with the constructor that takes a culture identifier parameter, the property value is one of the two-letter codes defined in ISO 3166 for the country/region and is formatted in uppercase. For example, the two-letter code for the United States is "US". +If the current object is created with the constructor that takes a culture identifier parameter, the property value is one of the two-letter codes defined in ISO 3166 for the country/region and is formatted in uppercase. For example, the two-letter code for the United States is "US". - If the current object is created with the constructor and is passed a full culture name such as "en-US", the property value is a full culture name in .NET Framework and just the region name in .NET Core and .NET 5+. +If the current object is created with the constructor and is passed a full culture name such as "en-US", the property value is a full culture name in .NET Framework and just the region name in .NET Core and .NET 5+. ## Examples - The following code example displays the properties of the class. - :::code language="csharp" source="~/snippets/csharp/System.Globalization/RegionInfo/CurrencySymbol/regioninfo_properties.cs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/System.Globalization/RegionInfo/CurrencySymbol/regioninfo_properties.vb" id="Snippet1"::: +The following code example displays the properties of the class. + +:::code language="csharp" source="~/snippets/csharp/System.Globalization/RegionInfo/CurrencySymbol/regioninfo_properties.cs" id="Snippet1"::: +:::code language="vb" source="~/snippets/visualbasic/System.Globalization/RegionInfo/CurrencySymbol/regioninfo_properties.vb" id="Snippet1"::: ]]> @@ -1231,18 +1231,17 @@ This constructor throws an if `name` is a neutra [!NOTE] > The property retrieves a full culture name if the `RegionInfo` object is constructed using a full culture name. - We recommend that you use the culture name - for example, "en-US" for English (United States) - to access the property. The string used for this property depends on the language associated with the country/region. For example, the culture names `en-US` for English (United States) and `es-US` for Spanish (United States) can retrieve different values on Windows Vista. Therefore, creating the `RegionInfo` object with only a country/region name of `US` is not specific enough to distinguish the appropriate string. +We recommend that you use the culture name–for example, "en-US" for English (United States)ndash;to access the property. The string used for this property depends on the language associated with the country/region. For example, the culture names `en-US` for English (United States) and `es-US` for Spanish (United States) can retrieve different values on Windows. Therefore, creating the `RegionInfo` object with only a country/region name of `US` is not specific enough to distinguish the appropriate string. ## Examples - The following code example demonstrates the property. - :::code language="csharp" source="~/snippets/csharp/System.Globalization/RegionInfo/CurrencyEnglishName/rgn5props.cs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/System.Globalization/RegionInfo/CurrencyEnglishName/rgn5props.vb" id="Snippet1"::: +The following code example demonstrates the property. + +:::code language="csharp" source="~/snippets/csharp/System.Globalization/RegionInfo/CurrencyEnglishName/rgn5props.cs" id="Snippet1"::: +:::code language="vb" source="~/snippets/visualbasic/System.Globalization/RegionInfo/CurrencyEnglishName/rgn5props.vb" id="Snippet1"::: ]]> @@ -1298,16 +1297,16 @@ This constructor throws an if `name` is a neutra property contains the three-letter code defined in ISO 3166 for this country/region. For example, the three-letter code for United States is "USA". +The property contains the three-letter code defined in ISO 3166 for this country/region. For example, the three-letter code for United States is "USA". - Case is not significant. However, the , , and properties return the appropriate code in uppercase. +Case is not significant. However, the , , and properties return the appropriate code in uppercase. ## Examples - The following code example displays the properties of the class. - :::code language="csharp" source="~/snippets/csharp/System.Globalization/RegionInfo/CurrencySymbol/regioninfo_properties.cs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/System.Globalization/RegionInfo/CurrencySymbol/regioninfo_properties.vb" id="Snippet1"::: +The following code example displays the properties of the class. + +:::code language="csharp" source="~/snippets/csharp/System.Globalization/RegionInfo/CurrencySymbol/regioninfo_properties.cs" id="Snippet1"::: +:::code language="vb" source="~/snippets/visualbasic/System.Globalization/RegionInfo/CurrencySymbol/regioninfo_properties.vb" id="Snippet1"::: ]]> @@ -1368,14 +1367,14 @@ This constructor throws an if `name` is a neutra class. - :::code language="csharp" source="~/snippets/csharp/System.Globalization/RegionInfo/CurrencySymbol/regioninfo_properties.cs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/System.Globalization/RegionInfo/CurrencySymbol/regioninfo_properties.vb" id="Snippet1"::: +The following code example displays the properties of the class. + +:::code language="csharp" source="~/snippets/csharp/System.Globalization/RegionInfo/CurrencySymbol/regioninfo_properties.cs" id="Snippet1"::: +:::code language="vb" source="~/snippets/visualbasic/System.Globalization/RegionInfo/CurrencySymbol/regioninfo_properties.vb" id="Snippet1"::: ]]> @@ -1433,14 +1432,13 @@ This constructor throws an if `name` is a neutra . +This method overrides . - This method returns the value of the property. +This method returns the value of the property. - Case is not significant. However, the , , and properties return the appropriate code in uppercase. +Case is not significant. However, the , , and properties return the appropriate code in uppercase. - The predefined names are listed on the class page. +The predefined names are listed on the class page. ]]> @@ -1500,24 +1498,24 @@ This constructor throws an if `name` is a neutra name is one of the two-letter codes defined in ISO 3166 for country/region. For example, the two-letter code for United States is "US". +The name is one of the two-letter codes defined in ISO 3166 for country/region. For example, the two-letter code for United States is "US". > [!IMPORTANT] > In some cases, the property may have more than two characters. For example, the value of the property for the Caribbean region is "029". - Case is not significant. However, the , , and properties return the appropriate code in uppercase. +Case is not significant. However, the , , and properties return the appropriate code in uppercase. > [!WARNING] > If you want to persist a object or communicate it between processes, you should instantiate it by using a full culture name rather than a two-letter ISO region code. Because properties depend on script and language, instantiating a object by using only a region code loses context and data. - The predefined names are listed in [ISO 3166: Country codes](https://www.iso.org/iso-3166-country-codes.html). +The predefined names are listed in [ISO 3166: Country codes](https://www.iso.org/iso-3166-country-codes.html). ## Examples - The following code example displays the properties of the class. - :::code language="csharp" source="~/snippets/csharp/System.Globalization/RegionInfo/CurrencySymbol/regioninfo_properties.cs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/System.Globalization/RegionInfo/CurrencySymbol/regioninfo_properties.vb" id="Snippet1"::: +The following code example displays the properties of the class. + +:::code language="csharp" source="~/snippets/csharp/System.Globalization/RegionInfo/CurrencySymbol/regioninfo_properties.cs" id="Snippet1"::: +:::code language="vb" source="~/snippets/visualbasic/System.Globalization/RegionInfo/CurrencySymbol/regioninfo_properties.vb" id="Snippet1"::: ]]> From b97a4b1fb66ed7858804339dc374f5876b8dd4f4 Mon Sep 17 00:00:00 2001 From: Genevieve Warren <24882762+gewarren@users.noreply.github.com> Date: Mon, 2 Feb 2026 08:44:49 -0800 Subject: [PATCH 2/2] Apply suggestions from code review Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- xml/System.Globalization/RegionInfo.xml | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/xml/System.Globalization/RegionInfo.xml b/xml/System.Globalization/RegionInfo.xml index 607380ff85b..82d3545459d 100644 --- a/xml/System.Globalization/RegionInfo.xml +++ b/xml/System.Globalization/RegionInfo.xml @@ -980,6 +980,9 @@ The following code example displays the properties of the property. +> [!NOTE] +> Currency symbols can change over time. Such changes are typically reflected through updates to the underlying OS or the ICU libraries. + | Country/region | Currency name | ISO 4217 currency symbol | | -------------------------------- | ---------------------- | ------------------------ | | Albania | Albanian Lek | ALL | @@ -1234,7 +1237,7 @@ The following code example displays the properties of the [!NOTE] > The property retrieves a full culture name if the `RegionInfo` object is constructed using a full culture name. -We recommend that you use the culture name–for example, "en-US" for English (United States)ndash;to access the property. The string used for this property depends on the language associated with the country/region. For example, the culture names `en-US` for English (United States) and `es-US` for Spanish (United States) can retrieve different values on Windows. Therefore, creating the `RegionInfo` object with only a country/region name of `US` is not specific enough to distinguish the appropriate string. +We recommend that you use the culture name–for example, "en-US" for English (United States)–to access the property. The string used for this property depends on the language associated with the country/region. For example, the culture names `en-US` for English (United States) and `es-US` for Spanish (United States) can retrieve different values on Windows. Therefore, creating the `RegionInfo` object with only a country/region name of `US` is not specific enough to distinguish the appropriate string. ## Examples