CultureAndRegionInfoBuilder.IetfLanguageTag Property

Definition

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

public string IetfLanguageTag { get; set; }

Property Value

A culture name formatted according to RFC 4646.

Exceptions

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.

Remarks

The IetfLanguageTag property gets or sets a culture name formatted according to RFC 4646, which can be different from the culture name returned by the Name property. For example, in the .NET Framework version 1.0, the neutral culture name for Traditional Chinese was "zh-CHT". In contrast, RFC 4646 defines that culture name as "zh-HANT". (Note that in the .NET Framework version 4, the Display Name for "zh-CHT" is "Chinese (Traditional) Legacy".)

An RFC 4646 culture name consists of several components. A typical culture name consists of a mandatory language identifier, an optional script identifier, and an optional country/region identifier. For example, a valid RFC 4646 culture name for the Serbian language, the Cyrillic script, and the region of Serbia is "sr-Cyrl-RS".

Note that two or more cultures can have the same IETF language tag.

For more information, see RFC 4646, "Tags for the Identification of Languages," at Request For Comments.

Applies to

Product Versions
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

See also