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::StringThe culture name in the format and language that the culture is set to display.
| Exception | Condition |
|---|---|
| ArgumentNullException | The value in a set operation is nullptr. |
| 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 */
- Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.
Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.