CultureAndRegionInfoBuilder::CultureNativeName Property
Gets or sets the culture name in the format and language that the culture is set to display.
Assembly: sysglobl (in sysglobl.dll)
Property Value
Type: System::String^The culture name in the format and language that the culture is set to display.
| Exception | Condition |
|---|---|
| ArgumentNullException | The value in a set operation is null. |
| ArgumentOutOfRangeException | The length of the value in a set operation does not range from 0 to 79 characters. |
The CultureNativeName property corresponds to the NativeName property.
The value of this property is the same, regardless of the language version of the .NET Framework.
The culture's full name might not display properly if the system is not set to display the culture's language correctly. For example, if the CultureName property is "ja-JP" for Japanese (Japan), the CultureNativeName property does not display correctly on a system that is set to English only. However, multilingual operating systems, such as Windows 2000, display the CultureNativeName property correctly.
The following code example creates a custom culture with a private use prefix, then lists a set of its properties. The first property lists the name of the culture.
// This example demonstrates a System.Globalization.Culture- // AndRegionInfoBuilder constructor and some of the properties // of a custom culture object created with the constructor. #using <sysglobl.dll> using namespace System; using namespace System::Globalization; int main() { CultureAndRegionInfoBuilder^ builder = gcnew CultureAndRegionInfoBuilder ("x-en-US-sample", CultureAndRegionModifiers::None); // Display some of the properties // for the en-US culture. Console::WriteLine("CultureName:. . . . . . . . . . {0}", builder->CultureName); Console::WriteLine("CultureEnglishName: . . . . . . {0}", builder->CultureEnglishName); Console::WriteLine("CultureNativeName:. . . . . . . {0}", builder->CultureNativeName); Console::WriteLine("GeoId:. . . . . . . . . . . . . {0}", builder->GeoId); Console::WriteLine("IsMetric: . . . . . . . . . . . {0}", builder->IsMetric); Console::WriteLine("ISOCurrencySymbol:. . . . . . . {0}", builder->ISOCurrencySymbol); Console::WriteLine("RegionEnglishName:. . . . . . . {0}", builder->RegionEnglishName); Console::WriteLine("RegionName: . . . . . . . . . . {0}", builder->RegionName); Console::WriteLine("RegionNativeName: . . . . . . . {0}", builder->RegionNativeName); Console::WriteLine("ThreeLetterISOLanguageName: . . {0}", builder->ThreeLetterISOLanguageName); Console::WriteLine("ThreeLetterISORegionName: . . . {0}", builder->ThreeLetterISORegionName); Console::WriteLine("ThreeLetterWindowsLanguageName: {0}", builder->ThreeLetterWindowsLanguageName); Console::WriteLine("ThreeLetterWindowsRegionName: . {0}", builder->ThreeLetterWindowsRegionName); Console::WriteLine("TwoLetterISOLanguageName: . . . {0}", builder->TwoLetterISOLanguageName); Console::WriteLine("TwoLetterISORegionName: . . . . {0}", builder->TwoLetterISORegionName); } /* This code example produces the following results: CultureName:. . . . . . . . . . en-US CultureEnglishName: . . . . . . English (United States) CultureNativeName:. . . . . . . English (United States) GeoId:. . . . . . . . . . . . . 244 IsMetric: . . . . . . . . . . . False ISOCurrencySymbol:. . . . . . . USD RegionEnglishName:. . . . . . . United States RegionName: . . . . . . . . . . US RegionNativeName: . . . . . . . United States ThreeLetterISOLanguageName: . . eng ThreeLetterISORegionName: . . . USA ThreeLetterWindowsLanguageName: ENU ThreeLetterWindowsRegionName: . USA TwoLetterISOLanguageName: . . . en TwoLetterISORegionName: . . . . US */
Available since 2.0