ResourceBundle.Control.GetCandidateLocales(String, Locale) メソッド

定義

名前空間:: Java.Util

アセンブリ:: Mono.Android.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

baseNameとlocaleの候補ロケールとしてLocaleのListを返します。

[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>

与えられた候補者のLocaleのListlocale

属性: RegisterAttribute

注釈

baseNameとlocaleの候補ロケールとしてLocaleのListを返します。このメソッドは、ファクトリメソッドがターゲット Localeのリソースバンドルを検索しようとするたびに、ResourceBundle.getBundle ファクトリメソッドによって呼び出されます。

候補ロケールのシーケンスは、候補ロケールの対応するリソースバンドルが存在し、その親が読み込まれたリソースバンドル自体によって定義されていない場合、ランタイムリソース参照パス ( 親チェーンとも呼ばれます) にも対応します。親チェーンのターミナルとして基本バンドルを使用する場合、リストの最後の要素は Locale#ROOT ルートロケールである必要があります。

指定されたロケールがLocale.ROOT (ルートロケール) と等しい場合は、ルート Localeのみを含むListを返す必要があります。この場合、 ResourceBundle.getBundle ファクトリメソッドは、ベースバンドルのみを結果のリソースバンドルとして読み込みます。

変更できない (変更できない) Listを返す必要はありません。ただし、返された List は、 getCandidateLocalesによって返された後に変更することはできません。

既定の実装では、以下で説明する規則を使用して、Localeを含むListが返されます。以下の説明では、 L、 S、 C および V は、それぞれ空でない言語、スクリプト、国、およびバリアントを表します。たとえば、[L、 C] は、言語と国に対してのみ空でない値を持つ Locale を表します。フォーム L("xx") は、(空でない) 言語値が "xx" であることを表します。いずれの場合も、最終的なコンポーネント値が空の文字列である Localeは省略されます。

<ol><li>空のスクリプト値を持つ入力 Locale の場合は、次のように最後のコンポーネントを 1 つずつ省略して候補 Localeを追加します。

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

<li>空でないスクリプト値を持つ入力 Locale では、最終的なコンポーネントを言語まで省略して候補 Localeを追加し、国とバリアントを復元して Locale から生成された候補を追加します。

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

<li>アンダースコアで区切られた複数のサブタグで構成されるバリアント値を持つ入力 Locale では、バリアントサブタグを 1 つずつ省略して候補の Localeを生成し、元のリストの完全なバリアント値を持つ Localeが出現するたびに挿入します。たとえば、バリアントが 2 つのサブタグ V1 と V2:

<ul><li> [L, S, C, V1, V2]</li><li> [L, S, C, V1]</li><li> [L, S, C]</li><li> [L, S]</li><li> [L, C, V1, V2]</li><li> [L, C, V1]</li><li> [L, C]</li><li> [L]</li><li>Locale.ROOT</li></ul></li>

<li>中国語の特別なケース。入力 Locale に言語 "zh" (中国語) と空のスクリプト値がある場合は、国によっては "Hans" (簡体字) または "Hant" (繁体字) が指定される場合があります。国が "CN" (中国) または "SG" (シンガポール) の場合は、"Hans" が提供されます。国が "HK" (香港特別行政区中国)、"MO" (マカオ特別行政区中国)、または "TW" (台湾) の場合は、"Hant" が提供されます。他のすべての国または国が空の場合は、スクリプトは提供されません。 For example, for Locale("zh", "CN") , the candidate list will be: <ul><li> [L("zh"), S("Hans"), C("CN")]</li><li> [L("zh"), S("Hans")]</li><li> [L("zh"), C("CN")]</li><li> [L("zh")]</li><li>Locale.ROOT</li></ul>

For Locale("zh", "TW"), the candidate list will be: <ul><li> [L("zh"), S("Hant"), C("TW")]</li><li> [L("zh"), S("Hant")]</li><li> [L("zh"), C("TW")]</li><li> [L("zh")]</li><li>Locale.ROOT</li></ul></li>

<li>ノルウェー語の特別なケース。 Locale("no", "NO", "NY")とLocale("nn", "NO")はどちらもノルウェー語 (ニーノシュク) を表します。ロケールの言語が "nn" の場合、標準候補リストは [L("nn")] まで生成され、次の候補が追加されます。

<ul><li> [L("no"), C("NO"), V("NY")]</li><li> [<emem >L("no"), C("NO")]</li><li> [L("no")]</li><li>Locale.ROOT</li></ul>

ロケールが正確に Locale("no", "NO", "NY")されている場合は、最初に Locale("nn", "NO") に変換され、次に上記の手順に従います。

また、Javaはノルウェーのブークム・#xE5 の類義語として「いいえ」を扱います。l "nb" 単一のケース Locale("no", "NO", "NY") (上記で処理) を除き、入力 Locale に言語 "no" または "nb" がある場合、言語コード "no" と "nb" を持つ候補 Localeがインターリーブされ、最初に要求された言語を使用してから、そのシノニムを使用します。たとえば、 Locale("nb", "NO", "POSIX") は次の候補リストを生成します。

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

Locale("no", "NO", "POSIX") は同じリストを生成しますが、"no" のロケールは対応するロケールの前に "nb".</li></ol>

既定の実装では、オーバーライドする実装が呼び出し元に返される前に変更できる ArrayList を使用します。ただし、サブクラスは、 getCandidateLocalesによって返された後で変更することはできません。

たとえば、指定したbaseNameが "メッセージ" で、指定されたlocaleがLocale("ja", "", "XX")場合、LocaleのList。

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

が返されます。また、"ja" と "" Localeのリソースバンドルが見つかった場合、ランタイムリソース参照パス (親チェーン) は次のようになります。

{@code
                Messages_ja -> Messages
            }

Javaドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

適用対象