sysglobl

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.

Initializes a new instance of the class.

The name of a culture. One of the values that specifies whether the new object is a neutral culture, replaces an existing culture and country/region, or is a new culture. is null. is the empty string (""). -or- contains characters other than "0" through "9", "a" through "z", "A" through "Z", hyphen (-), or underscore (_). -or- contains hyphens (-) to delimit components, but one or more of the , , , or components is absent. That is, two or more hyphens are adjacent. -or- is longer than 84 characters. -or- contains hyphens to delimit components, but one or more of the components is longer than 8 characters. -or- contains a leading or trailing hyphen (-) or underscore (_). -or- specifies an alternate sort replacement culture instead of a .NET Framework culture. For example, is "de-de_phoneb", a culture that sorts strings as they appear in a German telephone book, instead of "de-DE", the German (Germany) culture. -or- contains an invalid combination of values. -or- contains or and specifies a culture that is not found. -or- contains and specifies a user-created custom culture that does not replace a culture shipped with the .NET Framework. -or- contains and specifies a culture that is not a neutral culture. -or- contains and specifies a user-created custom culture that replaces a specific culture shipped with the .NET Framework.

Gets or sets an array of calendars that are supported by this object.

An array of calendars. In a set operation, the assigned array is null, or an element of the assigned array is null. This property is not supported for neutral cultures. -or- In a set operation, the assigned array contains , , , , , or .

Gets or sets the object that defines how to compare strings for the culture.

The object that defines how to compare strings for the culture. In a set operation the assigned value is null. This custom culture is an override of a built-in culture.

Gets or sets an alternate user interface culture suitable for console applications when the default graphic user interface culture is inappropriate.

An alternate neutral culture that is used to read and display text on the console. In a set operation where the specified culture is not null, the property of the specified culture is not the same as the specified culture.

Reconstitutes a object from a specified XML file that contains a representation of the object.

A new object that is equivalent to the information stored in the parameter. A file name that contains the XML representation of a object. is null. is an empty string (""), or invalid file or path name. The data in is not in valid XML format. -or- An I/O error occurred while accessing . The data in is not in valid LDML format.

Gets or sets the culture name in English.

The culture name in English. The value in a set operation is null. The length of the value in a set operation does not range from 0 to 79 characters.

Gets the name of the culture being created.

The culture name of the current object.

Gets or sets the culture name in the format and language that the culture is set to display.

The culture name in the format and language that the culture is set to display. The value in a set operation is null. The length of the value in a set operation does not range from 0 to 79 characters.

Gets the value that describes the culture represented by the current object.

One of the values.

Gets or sets the name, in English, of the currency used in the country/region represented by the current object.

The name, in English, of the currency used in the region. The value in a set operation is null. The value in a set operation is the empty string (""). The current object is a neutral culture.

Gets or sets the native name of the currency used in the country/region represented by the current object.

The name of the currency used in the country/region represented by the current object, formatted in the language associated with the ISO 3166 country/region code of the region. The value in a set operation is null. The value in a set operation is the empty string (""). The current object is a neutral culture.

Gets or sets a unique identification number for a geographical region, country, city, or location.

A 32-bit signed number that uniquely identifies a geographical location. The current object defines a neutral culture.

Gets or sets a object that defines the format of dates and times according to the Gregorian calendar.

A object. The value in a set operation is null. A property of the value in a set operation returned an invalid property value. The current object is a neutral culture.

Gets or sets a culture name formatted according to the RFC 4646 standard, "Tags for the Identification of Languages."

A culture name formatted according to RFC 4646. In a set operation, the value is null. In a set operation, the length of the value is not from 1 through 84 characters. In a set operation, a component of the name specified in the value is empty or longer than 8 characters, not an alphanumeric character or hyphen (-), or the name contains a leading or trailing hyphen.

Gets or sets a value indicating whether the country/region uses the metric system for measurements.

true if the country/region uses the metric system for measurements; otherwise, false. This operation is not valid for a neutral culture.

Gets or sets the three-character ISO 4217 currency symbol associated with the country/region.

The three-character ISO 4217 currency symbol associated with the country/region. This is a neutral culture. In a set operation, the value is null. In a set operation, the value is not from 0 through 8 characters long.

Gets or sets the predominant direction of lines of text in the writing system associated with the current object.

true if the predominant direction of lines of text in the current writing system is right-to-left; otherwise, false.

Gets or sets the active input locale identifier.

A 32-bit signed number that specifies an input locale identifier. In a set operation, the value is zero.

Gets the culture identifier for the current object.

The culture identifier for the current object.

Sets the properties of the current object with the corresponding properties of the specified object.

A object to read. is null.

Sets the properties of the current object with the corresponding properties of the specified object.

A object to read. is null. Country/region information cannot be set because the current object specifies a neutral culture.

Gets or sets a object that defines the culturally appropriate format of displaying numbers, currency, and percentage.

A object that defines the culturally appropriate format of displaying numbers, currency, and percentage. The value in a set operation is null. This operation is not valid for a neutral culture. The specification for a number, currency, or percent property for this culture contains too many digits or is out of range.

Gets or sets the object that represents the parent culture of the current custom culture.

The object that represents the parent culture of the current custom culture. In a set operation, the culture value cannot be found. Possibly, the assigned value is an unregistered custom culture. In a set operation, the value is null. In a set operation, which traverses the ancestors of the current culture, the invariant culture cannot be found within 10 generations of ancestors. -or- In a set operation, a circular reference was discovered: the assigned value is an ancestor of the current custom culture.

Gets or sets the full name of the country/region in English.

The full name of the country/region in English. This operation is not valid for a neutral culture. The value in a set operation is null. The length of the value in a set operation does not range from 0 to 79 characters.

Gets the name of the country/region for the current object.

The name of the country/region for the current object. This operation is not valid for a neutral culture.

Gets or sets the full name of the country/region as known by the people of this custom culture.

The local name of the country/region. This operation is not valid for a neutral culture. The value in a set operation is null. The length of the value in a set operation does not range from 1 to 79 characters.

Persists the current object as a custom culture on the local computer and makes that culture available to applications. Requires administrative privileges.

The custom culture is already registered. -or- The current object has a property that must be set before the culture can be registered. All cultures, neutral or specific, must have and set. Specific cultures must also have , , and set. This method also throws if the following properties are not defined: A object property value exceeds its maximum length or value. User does not have administrative privileges.

Writes an XML representation of the current object to the specified file.

The name of a file to contain the XML representation of this custom culture. is null. is an empty string (""). The value of a property of a , , or object contained in the current object is invalid.

Gets or sets the object that defines the writing system associated with this custom culture.

The object that defines the writing system associated with this custom culture. This operation is not supported for replacement cultures. The value in a set operation is null. The number of characters in a list separator does not range from 0 to 3 characters.

Gets or sets the ISO 639-2 three-letter code for the language of this custom culture.

The ISO 639-2 three-letter code for the language of the current object. The value in a set operation is null. The length of the value in a set operation does not range from 1 to 8 characters. The value in a set operation contains a character that is not in the range "a" to "z", "A" to "Z", or "0" to "9".

Gets or sets the three-letter code defined in ISO 3166 for the country/region.

The three-letter code defined in ISO 3166 for the country/region. The value in a set operation is null. The length of the value in a set operation does not range from 1 to 8 characters. The value in a set operation contains a character that is not in the range "a" to "z", "A" to "Z", or "0" to "9".

Gets or sets the three-letter code for the language as defined in the Windows API.

The three-letter code for the language as defined in the Windows API. The value in a set operation is null. The length of the value in a set operation does not range from 1 to 8 characters. The value in a set operation contains a character that is not in the range "a" to "z", "A" to "Z", or "0" to "9". In a set operation, the current custom culture is a replacement culture.

Gets or sets the three-letter code assigned by Windows to the country/region represented by the current custom culture.

The three-letter code assigned by Windows to the country/region represented by this object. The value in a set operation is null. The length of the value in a set operation does not range from 1 to 8 characters. The value in a set operation contains a character that is not in the range "a" to "z", "A" to "Z", or "0" to "9". In a set operation, the current custom culture is a replacement culture or a neutral culture.

Gets or sets the ISO 639-1 two-letter code for the language of the current object.

The ISO 639-1 two-letter code for the language of the current object. The value in a set operation is null. The length of the value in a set operation does not range from 1 to 8 characters. The value in a set operation contains a character that is not in the range "a" to "z", "A" to "Z", or "0" to "9".

Gets or sets the two-letter code defined in ISO 3166 for the country/region.

The two-letter code defined in ISO 3166 for the country/region. The value in a set operation is null. The length of the value in a set operation does not range from 1 to 8 characters. The value in a set operation contains a character that is not in the range "a" to "z", "A" to "Z", or "0" to "9". In a set operation, the current custom culture is a neutral culture.

Deletes a custom culture from the local computer.

The name of a custom culture. is a parent culture or console fallback user interface culture of a dependent culture. Application does not have administrative privileges. specifies a culture that is not found.

Specifies constants that define a object.

A specific, supplemental custom culture.

A neutral custom culture.

A custom culture that replaces an existing .NET Framework culture or Windows locale.