Конструктор System.Globalization.CultureAndRegionInfoBuilder

В этой статье приводятся дополнительные замечания к справочной документации по этому API.

Эта статья относится к конструктору CultureAndRegionInfoBuilder(String, CultureAndRegionModifiers) .

Параметр cultureName задает имя нового CultureAndRegionInfoBuilder объекта.

Параметр flags используется для CultureAndRegionModifiers значения, указывающего, является ли новый CultureAndRegionInfoBuilder объект новым пользовательским языком и региональными параметрами или заменяет существующий нейтральный язык и региональные параметры, определенные региональные параметры или языковой стандарт Windows.

cultureName Если параметр задает существующий язык и региональные параметры .NET, зарегистрированные пользовательские региональные параметры или региональные параметры, созданные на основе языкового стандарта Windows, CultureAndRegionInfoBuilder конструктор автоматически заполняет новый CultureAndRegionInfoBuilder объект сведениями о языке и региональных параметрах и странах или регионах.

Заполните новый CultureAndRegionInfoBuilder объект сведениями о языке и стране или регионе, вызвав методы и LoadDataFromRegionInfo региональные LoadDataFromCultureInfo параметры.

Пользовательские имена языка и региональных параметров

Предпочтительный формат параметра для нового пользовательского cultureName языка и региональных параметров — "[prefix-]language[-region…suffix][-]]", где language компонент является обязательным, а prefixregionsuffix также компоненты являются необязательными. Максимальная длина каждого компонента составляет 8 символов, а максимальная длина всего cultureName параметра составляет 84 символа.

Компонент prefix — это идентификация центра назначения номеров Интернета (IANA). Укажите "i-" или "I-" для имен языка и региональных параметров, зарегистрированных в IANA, или "x-" или "X-" для имен языка и региональных параметров, зарезервированных для частного использования. В противном случае префикс не требуется. Дополнительные сведения см. в разделе RFC 4646 , "Теги для идентификации языков".

Компонент languagecultureName параметра задает строчные двухбуквенный код, производный от ISO 639-1, и region задает двухбуквенный код, производный от ISO 3166. Например, en-US означает английский язык, как говорится в США. Отсутствие region компонента означает нейтральный язык и региональные параметры.

Значение cultureName , которое совпадает с именем языка и региональных параметров, включенных в .NET, означает замену (переопределение) языка и региональных параметров. Значения, которые можно назначить свойствам языка и региональных параметров замены, ограничены. Дополнительные сведения об этих ограничениях см. в исключениях для каждого свойства.

Приложение использует suffix компонент для различения аналогичных языков и региональных параметров. Например, две компании ABC и XYZ создают и совместно используют новую веб-службу ASP.NET для продвижения продуктов на разных рынках по всему миру. Веб-страницы для службы отображают такие сведения, как региональный логотип и местный номер телефона каждой компании в зависимости от языка и региональных параметров пользователя. Содержимое для каждой веб-страницы зависит от языка и региональных параметров в отдельных файлах ресурсов, определенных по имени языка и региональных параметров. Например, файлы ресурсов для региональных параметров en-US и ja-JP называются en-US-ABC, en-US-XYZ, ja-JP-ABC и ja-JP-XYZ. Суффиксы ABC и XYZ позволяют веб-службе использовать ту же логику приложения для отображения различных сведений о рынке.

Компонент suffix может состоять из подкомпонентов, где каждый вложенный компонент разделен дефисом, а максимальная длина каждого подкомпонента составляет 8 символов. Например, если "en-US-honda-cars" является параметром cultureName , "-honda-автомобили" является компонентом suffix .