ResourceBundle.Control.GetCandidateLocales(String, Locale) Метод

Ссылка

Определение

Пространство имен:: Java.Util

Сборка:: Mono.Android.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Возвращает из List s в качестве потенциальных Localeязыковых стандартов для baseName и locale.

[Android.Runtime.Register("getCandidateLocales", "(Ljava/lang/String;Ljava/util/Locale;)Ljava/util/List;", "GetGetCandidateLocales_Ljava_lang_String_Ljava_util_Locale_Handler")]
public virtual System.Collections.Generic.IList<Java.Util.Locale>? GetCandidateLocales (string baseName, Java.Util.Locale locale);

[<Android.Runtime.Register("getCandidateLocales", "(Ljava/lang/String;Ljava/util/Locale;)Ljava/util/List;", "GetGetCandidateLocales_Ljava_lang_String_Ljava_util_Locale_Handler")>]
abstract member GetCandidateLocales : string * Java.Util.Locale -> System.Collections.Generic.IList<Java.Util.Locale>
override this.GetCandidateLocales : string * Java.Util.Locale -> System.Collections.Generic.IList<Java.Util.Locale>

Параметры

baseName: String

базовое имя пакета ресурсов, полное имя класса

locale: Locale

языковой стандарт, для которого необходим пакет ресурсов

Возвращаемое значение

IList<Locale>

a List из кандидатов Localeдля заданного locale

Атрибуты: RegisterAttribute

Возвращает из List s в качестве потенциальных Localeязыковых стандартов для baseName и locale. Этот метод вызывается фабричном ResourceBundle.getBundle методом каждый раз, когда метод фабрики пытается найти пакет ресурсов для целевого объекта Locale.

Последовательность потенциальных языковых стандартов также соответствует пути поиска ресурсов среды выполнения (также известной как родительская цепочка), если существуют соответствующие пакеты ресурсов для потенциальных языковых стандартов и их родители не определены загруженными пакетами ресурсов. Последний элемент списка должен быть корневым языковым стандартом Locale#ROOT, если требуется, чтобы базовый пакет был терминалом родительской цепочки.

Если заданный языковой стандарт равен Locale.ROOT (корневой языковой List стандарт), необходимо вернуть , содержащий только корень Locale . В этом случае ResourceBundle.getBundle заводской метод загружает только базовый пакет в качестве результирующего пакета ресурсов.

Не обязательно возвращать неизменяемый (неизменяемый) Listобъект . Однако возвращаемый List объект не должен изменяться после того, как он был возвращен .getCandidateLocales

Реализация по умолчанию возвращает объект , List содержащий Locale, используя описанные ниже правила. В приведенном ниже <описании em>L, S, C и V соответственно представляют непустый язык, скрипт, страну и вариант. Например, [em L/em>, C] представляет объект Locale , имеющий непустые значения только для языка и страны.<>< Форма L("xx") представляет значение языка (непустое) значение "xx". Во всех случаях конечные Localeзначения компонентов которых являются пустыми строками, опущены.

<ol><li>Для входных данных Locale с пустым значением скрипта добавьте потенциальные Locales, пропуская по одному окончательный компонент, как показано ниже:

<Li>Для входных данных Locale с непустым значением скрипта добавьте потенциальные Locales, опустив окончательный компонент до языка, а затем добавьте кандидаты, созданные Locale из , с восстановленными страной и вариантом:

<ul><li> [L, S, C, V]</li<>li> [L, S, C]</li<>[<>em>L</em,em><> S]</li<>> [L, C</em,>V]</li><li> [L, C]</li>>< [L]</li<>li<>Locale.ROOT/li/li></ul></li>

<Li>Для входных данных Locale со значением variant, состоящим из нескольких подтегов, разделенных подчеркиванием, создайте потенциальные Locales, пропуская подтеги варианта один за одним, а затем вставьте их после каждого вхождения Locales с полным значением variant в исходном списке. Например, если вариант состоит из двух подтегов V1 и V2:

<ul><li> [L, S, C, V1, V2]</li<>> [L, S</em, C>, V1]</li>>< [L, S, C</em]></Литий><li> [L, S]</li>>< [L, C, V1, V2]</li><li> [L, C, V1]</li>>< li [L, ]</li><li> [L]</li>Locale.ROOT<></li></ul></li>

<li>Особые случаи для китайского языка. Если входные данные Locale имеют язык "zh" (китайский) и пустое значение скрипта, в зависимости от страны могут быть предоставлены "Hans" (упрощенное письмо) или "Hant" (традиционное письмо). Когда страна "CN" (Китай) или "SG" (Сингапур), "Hans" поставляется. Когда страна "HK" (Гонконг, САР Китай), "MO" (Макао САР Китай), или "TW" (Тайвань), "Hant" поставляется. Для всех остальных стран или когда страна пуста, сценарий не предоставляется. Например, для Locale("zh", "CN") список кандидатов будет: <ul<>li> [L("zh"), S("Hans"), C("CN")]</li>>< [L("zh"), S("Hans")/<li><> [L("zh"), em C/em("CN")]/li [em L/em("zh"), em>C("CN")]</li<>> [L("zh" <")]</li>Locale.ROOT><</li></ul>

Для Locale("zh", "TW")список кандидатов будет: <ul><li> [L("zh"), S("Hant"), C("TW")]</li<>> [L("zh"), S("Hant")/<li><> [L("zh"), C("TW")]</li><> [L("zh")]/< li><li>Locale.ROOT</li></ul></li>

<li>Особые случаи для норвежского языка. Оба Locale("no", "NO", "NY") и Locale("nn", "NO") представляют норвежский Нюнорск. Если язык языкового стандарта — "nn", создается стандартный список кандидатов до [L("nn")], а затем добавляются следующие кандидаты:

Если языковой стандарт имеет точное Locale("no", "NO", "NY")значение , сначала он преобразуется в Locale("nn", "NO") , а затем выполняется описанная выше процедура.

Кроме того, Java рассматривает язык "no" как синоним норвежского bokmål "nb". За исключением одного регистра Locale("no", "NO", "NY") (описанного выше), когда входные данные Locale имеют язык "нет" или "nb", кандидаты Localeс кодами языка "нет" и "nb" чередуются, сначала используя запрошенный язык, а затем его синоним. Например, Locale("nb", "NO", "POSIX") создает следующий список кандидатов:

<ul><li> [L("nb"), C("NO"), V("POSIX")]</li>>< [L("no"), C("NO"), V("POSIX")]</li><> [L("nb"), C("NO")]</li><> [L("no"), C("NO")]</li>>< [L("nb")]</li>>< [L("no")]</liLocale.ROOT<<>>/li></ul>

Locale("no", "NO", "POSIX") создаст тот же список, за исключением того, что языковые параметры с "no" будут отображаться перед соответствующими языковыми параметрами с "nb".</li></ol>

Реализация по умолчанию использует объект , ArrayList который переопределяющие реализации могут изменить перед возвратом вызывающему объекту. Однако подкласс не должен изменять его после того, как он был возвращен getCandidateLocales.

Например, если задано baseName значение "Сообщения", а заданное locale — Locale("ja", "", "XX"), то значение типа LocaleList s:

Locale("ja", "", "XX")
                Locale("ja")
                Locale.ROOT

. А если найдены пакеты ресурсов для "ja" и "" Locale, то путь поиска ресурса среды выполнения (родительская цепочка) будет следующим:

{@code
                Messages_ja -> Messages
            }

Документация по Java для java.util.ResourceBundle.Control.getCandidateLocales(java.lang.String, java.util.Locale).

Части этой страницы являются изменениями, основанными на работе, созданной и совместно используемой проектом и используемой в соответствии с условиями, Creative Commons 2.5 Attribution License Creative Commons 2.5 Attribution License.

Применяется к

Поделиться через

ResourceBundle.Control.GetCandidateLocales(String, Locale) Метод

Определение

Параметры

Возвращаемое значение

Комментарии

Применяется к

Дополнительные ресурсы