Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

CultureAndRegionInfoBuilder Class

Defines a custom culture that is new or based on another culture and country/region. The custom culture can be installed on a computer and subsequently used by any application running on that computer. This class cannot be inherited.

System.Object
  System.Globalization.CultureAndRegionInfoBuilder

Namespace:  System.Globalization
Assembly:  sysglobl (in sysglobl.dll)
[ComVisibleAttribute(false)]
public sealed class CultureAndRegionInfoBuilder

The CultureAndRegionInfoBuilder type exposes the following members.

  NameDescription
Public methodCultureAndRegionInfoBuilderInitializes a new instance of the CultureAndRegionInfoBuilder class.
Top
  NameDescription
Public propertyAvailableCalendarsGets or sets an array of calendars that are supported by this CultureAndRegionInfoBuilder object.
Public propertyCompareInfoGets or sets the CompareInfo object that defines how to compare strings for the culture.
Public propertyConsoleFallbackUICultureGets or sets an alternate user interface culture suitable for console applications when the default graphic user interface culture is inappropriate.
Public propertyCultureEnglishNameGets or sets the culture name in English.
Public propertyCultureNameGets the name of the culture being created.
Public propertyCultureNativeNameGets or sets the culture name in the format and language that the culture is set to display.
Public propertyCultureTypesGets the CultureTypes value that describes the culture represented by the current CultureAndRegionInfoBuilder object.
Public propertyCurrencyEnglishNameGets or sets the name, in English, of the currency used in the country/region represented by the current CultureAndRegionInfoBuilder object.
Public propertyCurrencyNativeNameGets or sets the native name of the currency used in the country/region represented by the current CultureAndRegionInfoBuilder object.
Public propertyGeoIdGets or sets a unique identification number for a geographical region, country, city, or location.
Public propertyGregorianDateTimeFormatGets or sets a DateTimeFormatInfo object that defines the format of dates and times according to the Gregorian calendar.
Public propertyIetfLanguageTagGets or sets a culture name formatted according to the RFC 4646 standard, "Tags for the Identification of Languages."
Public propertyIsMetricGets or sets a value indicating whether the country/region uses the metric system for measurements.
Public propertyISOCurrencySymbolGets or sets the three-character ISO 4217 currency symbol associated with the country/region.
Public propertyIsRightToLeftGets or sets the predominant direction of lines of text in the writing system associated with the current CultureAndRegionInfoBuilder object.
Public propertyKeyboardLayoutIdGets or sets the active input locale identifier.
Public propertyLCIDGets the culture identifier for the current CultureAndRegionInfoBuilder object.
Public propertyNumberFormatGets or sets a NumberFormatInfo object that defines the culturally appropriate format of displaying numbers, currency, and percentage.
Public propertyParentGets or sets the CultureInfo object that represents the parent culture of the current custom culture.
Public propertyRegionEnglishNameGets or sets the full name of the country/region in English.
Public propertyRegionNameGets the name of the country/region for the current CultureAndRegionInfoBuilder object.
Public propertyRegionNativeNameGets or sets the full name of the country/region as known by the people of this custom culture.
Public propertyTextInfoGets or sets the TextInfo object that defines the writing system associated with this custom culture.
Public propertyThreeLetterISOLanguageNameGets or sets the ISO 639-2 three-letter code for the language of this custom culture.
Public propertyThreeLetterISORegionNameGets or sets the three-letter code defined in ISO 3166 for the country/region.
Public propertyThreeLetterWindowsLanguageNameGets or sets the three-letter code for the language as defined in the Windows API.
Public propertyThreeLetterWindowsRegionNameGets or sets the three-letter code assigned by Windows to the country/region represented by the current custom culture.
Public propertyTwoLetterISOLanguageNameGets or sets the ISO 639-1 two-letter code for the language of the current CultureInfo object.
Public propertyTwoLetterISORegionNameGets or sets the two-letter code defined in ISO 3166 for the country/region.
Top
  NameDescription
Public methodStatic memberCreateFromLdmlReconstitutes a CultureAndRegionInfoBuilder object from a specified XML file that contains a representation of the object.
Public methodEquals(Object)Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
Protected methodFinalizeAllows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
Public methodGetHashCodeServes as a hash function for a particular type. (Inherited from Object.)
Public methodGetTypeGets the Type of the current instance. (Inherited from Object.)
Public methodLoadDataFromCultureInfoSets the properties of the current CultureAndRegionInfoBuilder object with the corresponding properties of the specified CultureInfo object.
Public methodLoadDataFromRegionInfoSets the properties of the current CultureAndRegionInfoBuilder object with the corresponding properties of the specified RegionInfo object.
Protected methodMemberwiseCloneCreates a shallow copy of the current Object. (Inherited from Object.)
Public methodRegisterPersists the current CultureAndRegionInfoBuilder object as a custom culture on the local computer and makes that culture available to applications. Requires administrative privileges.
Public methodSaveWrites an XML representation of the current CultureAndRegionInfoBuilder object to the specified file.
Public methodToStringReturns a string that represents the current object. (Inherited from Object.)
Public methodStatic memberUnregisterDeletes a custom culture from the local computer.
Top

The CultureInfo class holds culture-specific information, such as the associated language, sublanguage, country/region, calendar, and cultural conventions. This class also provides culture-specific instances of the DateTimeFormatInfo, NumberFormatInfo, CompareInfo, and TextInfo classes, which are required for culture-specific operations such as casing, formatting and parsing dates and numbers, and comparing strings.

However, only the cultures predefined in the CultureInfo class are available to applications. The application should use the CultureAndRegionInfoBuilder class to create a custom culture that is new or overrides a predefined culture, and to install the custom culture on a computer. An installed custom culture is said to be registered on a computer, and can be used by any application running on that computer.

Note that a custom culture can be registered on a computer only by a user who has administrative rights on that computer. Consequently, typical applications cannot create a custom culture. Instead, the application uses the CultureAndRegionInfoBuilder class to build a tool that an administrator can use to create and register a custom culture. After the custom culture is registered on a computer, the application uses the CultureInfo class to create an instance of the custom culture just as it would a predefined culture.

If your application parses a date and time string generated for a custom culture, it should use the TryParseExact method instead of the TryParse method to improve the probability that the parse operation will succeed. A custom culture date and time string can be complicated, and therefore difficult to parse. The TryParse method attempts to parse a string with several implicit parse patterns, all of which might fail. The TryParseExact method, in contrast, requires the application to explicitly designate one or more exact parse patterns that are likely to succeed.

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

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.
Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.