ResourceBundle クラス

リファレンス

定義

名前空間:: Java.Util

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

重要

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

リソースバンドルには、ロケール固有のオブジェクトが含まれています。

[Android.Runtime.Register("java/util/ResourceBundle", DoNotGenerateAcw=true)]
public abstract class ResourceBundle : Java.Lang.Object

[<Android.Runtime.Register("java/util/ResourceBundle", DoNotGenerateAcw=true)>]
type ResourceBundle = class
    inherit Object

継承: Object

Object
ResourceBundle

派生: Java.Util.ListResourceBundle

Java.Util.PropertyResourceBundle

属性: RegisterAttribute

注釈

リソースバンドルには、ロケール固有のオブジェクトが含まれています。たとえば、 String プログラムにロケール固有のリソースが必要な場合、プログラムは現在のユーザーのロケールに適したリソースバンドルから読み込むことができます。これにより、リソースバンドル内のロケール固有の情報のほとんど (すべてではないにしても) を分離するユーザーのロケールに大きく依存しないプログラムコードを記述できます。

これにより、UL>LI をさまざまな言語<に簡単にローカライズまたは翻訳できるプログラム<を記述できます。LI> は、一度に複数のロケールを一度<>に処理し、後で簡単に変更して、さらに多くのロケール </UL をサポートできます><>

リソースバンドルは、メンバーが共通の基本名を共有しているが、その名前にはロケールを識別する追加のコンポーネントも含まれるファミリに属します。たとえば、リソースバンドルのファミリの基本名は"MyResources" である場合があります。ファミリには、ファミリと同じ名前 ("MyResources" ) を持つ既定のリソースバンドルが必要です。特定のロケールがサポートされていない場合は、最後のリゾートのバンドルとして使用されます。その後、ファミリは、必要に応じてロケール固有のメンバー ("MyResources_de" という名前のドイツ人メンバーなど) を提供できます。

ファミリ内の各リソースバンドルには同じアイテムが含まれていますが、そのアイテムは、そのリソースバンドルによって表されるロケール用に翻訳されています。たとえば、"MyResources" と "MyResources_de" の両方に、操作を取り消すボタンで使用されるが含まれる場合があります String 。 "MyResources" では、 String に "Cancel" を含め、"MyResources_de" には "Abbrechen" が含まれる場合があります。

国ごとに異なるリソースがある場合は、特殊化を行うことができます。たとえば、"MyResources_de_CH" にはスイス (CH) のドイツ語 (de) のオブジェクトが含まれています。特殊化の一部のリソースのみを変更する場合は、変更できます。

プログラムでロケール固有のオブジェクトが必要な場合は、メソッド <blockquote をResourceBundle使用してクラスを#getBundle(java.lang.String, java.util.Locale) getBundle読み込みます。>

ResourceBundle myResources =
                 ResourceBundle.getBundle("MyResources", currentLocale);

</blockquote>

リソースバンドルには、キーと値のペアが含まれています。キーは、バンドル内のロケール固有のオブジェクトを一意に識別します。 2 つのキーと値のペアを含むの ListResourceBundle 例を次に示します。 <blockquote>

public class MyResources extends ListResourceBundle {
                protected Object[][] getContents() {
                    return new Object[][] {
                        // LOCALIZE THE SECOND STRING OF EACH ARRAY (e.g., "OK")
                        {"OkKey", "OK"},
                        {"CancelKey", "Cancel"},
                        // END OF MATERIAL TO LOCALIZE
                   };
                }
            }

</blockquote> キーは常に Strings です。この例では、キーは "OkKey" と "CancelKey" です。上記の例では、値も Strings--"OK" と "Cancel"--ですが、そうである必要はありません。値には、任意の種類のオブジェクトを指定できます。

適切な getter メソッドを使用して、リソースバンドルからオブジェクトを取得します。 "OkKey" と "CancelKey" は両方とも文字列であるため、それらを<取得するには blockquote を使用getStringします。>

button1 = new Button(myResources.getString("OkKey"));
            button2 = new Button(myResources.getString("CancelKey"));

</blockquote> getter メソッドはすべて引数としてキーを必要とし、見つかった場合はオブジェクトを返します。オブジェクトが見つからない場合、getter メソッドはを MissingResourceExceptionスローします。

に加getStringResourceBundleえて、getStringArray文字列配列を取得するためのメソッド、および他の種類のオブジェクトのジェネリック getObject メソッドも提供します。を使用 getObjectする場合は、結果を適切な型にキャストする必要があります。例: <blockquote>

int[] myIntegers = (int[]) myResources.getObject("intList");

</blockquote>

Java プラットフォームには、との ResourceBundleListResourceBundle 2 つのサブクラスが用意されていますPropertyResourceBundle。これは、リソースを作成する非常に簡単な方法を提供します。前の例で簡単に説明したように、 ListResourceBundle そのリソースはキーと値のペアの一覧として管理されます。 PropertyResourceBundle では、プロパティファイルを使用してそのリソースを管理します。

必要に応じて、またはPropertyResourceBundleニーズに合わない場合ListResourceBundleは、独自ResourceBundleのサブクラスを記述できます。サブクラスは、と getKeys()の 2 つのメソッドをオーバーライドするhandleGetObject必要があります。

サブクラスを複数のスレッドで ResourceBundle 同時に使用する場合、サブクラスの実装はスレッドセーフである必要があります。このクラスの非抽象メソッドの既定の実装と、直接の既知の具象サブクラス ListResourceBundle 内のメソッドと PropertyResourceBundle はスレッドセーフです。

<h3>ResourceBundle.Control</h3>

クラスは ResourceBundle.Control 、インスタンスを取得するファクトリメソッドによってバンドルの読み込みプロセスを getBundle 実行するために必要な情報を ResourceBundle.Control 提供します。標準以外のリソースバンドル形式を有効にしたり、検索戦略を変更したり、キャッシュパラメーターを定義したりするために、独自のサブクラスを実装できます。詳細については、クラスとファクトリメソッドの #getBundle(String, Locale, ClassLoader, Control) getBundle 説明を参照してください。

<h3>キャッシュ管理</h3>

ファクトリメソッドによって getBundle 作成されたリソースバンドルインスタンスは既定でキャッシュされ、ファクトリメソッドはキャッシュされている場合に同じリソースバンドルインスタンスを複数回返します。 getBundle クライアントは、キャッシュをクリアしたり、キャッシュされたリソースバンドルインスタンスの有効期間を Time-to-Live 値を使用して管理したり、リソースバンドルインスタンスをキャッシュしないように指定したりできます。詳細については、#getBundle(String、Locale、ClassLoader、Control) <コード>getBundle</code> factory メソッド、、、#clearCache(ClassLoader) clearCacheControl#getTimeToLive(String, Locale) ResourceBundle.Control.getTimeToLiveおよび Control#needsReload(String, Locale, String, ClassLoader, ResourceBundle, long) ResourceBundle.Control.needsReload の説明を参照してください。

<h3>Example</h3>

2 つのリソースを ResourceBundle 管理するサブクラス MyResourcesの非常に単純な例を次に示します (より多くのリソースの場合は、 Mapを使用する可能性があります)。 "親レベル" ResourceBundle が同じ値を持つ同じキーを処理する場合は、値を指定する必要はありません (以下の okKey の場合と同様)。 <blockquote>

// default (English language, United States)
            public class MyResources extends ResourceBundle {
                public Object handleGetObject(String key) {
                    if (key.equals("okKey")) return "Ok";
                    if (key.equals("cancelKey")) return "Cancel";
                    return null;
                }

                public Enumeration&lt;String&gt; getKeys() {
                    return Collections.enumeration(keySet());
                }

                // Overrides handleKeySet() so that the getKeys() implementation
                // can rely on the keySet() value.
                protected Set&lt;String&gt; handleKeySet() {
                    return new HashSet&lt;String&gt;(Arrays.asList("okKey", "cancelKey"));
                }
            }

            // German language
            public class MyResources_de extends MyResources {
                public Object handleGetObject(String key) {
                    // don't need okKey, since parent level handles it.
                    if (key.equals("cancelKey")) return "Abbrechen";
                    return null;
                }

                protected Set&lt;String&gt; handleKeySet() {
                    return new HashSet&lt;String&gt;(Arrays.asList("cancelKey"));
                }
            }

</blockquote> 単一のファミリを ResourceBundle使用するように自分自身を制限する必要はありません。たとえば、例外メッセージ (、ExceptionResources_de...) のバンドルのセットと、 ExceptionResources ウィジェット用のバンドル (WidgetResources_frExceptionResources_fr、 WidgetResource 、WidgetResources_de...)、リソースを好きなように分割することができます。

1.1 で追加されました。

の Java ドキュメント java.util.ResourceBundle。

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

コンストラクター

ResourceBundle()	唯一のコンストラクター。
ResourceBundle(IntPtr, JniHandleOwnership)	JNI オブジェクトのマネージド表現を作成するときに使用されるコンストラクター。ランタイムによって呼び出されます。

プロパティ

BaseBundleName	既知の場合、または `null` 不明な場合は、このバンドルの基本名を返します。
Class	この `Object`のランタイムクラスを返します。 (継承元 Object)
Handle	基になる Android インスタンスへのハンドル。 (継承元 Object)
JniIdentityHashCode	リソースバンドルには、ロケール固有のオブジェクトが含まれています。 (継承元 Object)
JniPeerMembers	リソースバンドルには、ロケール固有のオブジェクトが含まれています。
Keys	この `ResourceBundle`に含まれるリソースの名前を返します。
Locale	このリソースバンドルのロケールを返します。
Parent	このバンドルの親バンドル。
PeerReference	リソースバンドルには、ロケール固有のオブジェクトが含まれています。 (継承元 Object)
ThresholdClass	この API は Android 用 Mono インフラストラクチャをサポートしており、コードから直接使用することを意図したものではありません。
ThresholdType	この API は Android 用 Mono インフラストラクチャをサポートしており、コードから直接使用することを意図したものではありません。

メソッド

ClearCache()	呼び出し元のクラスローダーを使用して読み込まれたキャッシュからすべてのリソースバンドルを削除します。
ClearCache(ClassLoader)	指定されたクラスローダーによって読み込まれたすべてのリソースバンドルをキャッシュから削除します。
Clone()	このオブジェクトのコピーを作成して返します。 (継承元 Object)
ContainsKey(String)	指定 `key` されたがこの `ResourceBundle` バンドルまたはその親バンドルに含まれているかどうかを判断します。
Dispose()	リソースバンドルには、ロケール固有のオブジェクトが含まれています。 (継承元 Object)
Dispose(Boolean)	リソースバンドルには、ロケール固有のオブジェクトが含まれています。 (継承元 Object)
Equals(Object)	他のオブジェクトがこのオブジェクトと "等しい" かどうかを示します。 (継承元 Object)
GetBundle(String)	指定した基本名、既定のロケール、および呼び出し元のクラスローダーを使用して、リソースバンドルを取得します。
GetBundle(String, Locale)	指定した基本名とロケール、および呼び出し元のクラスローダーを使用して、リソースバンドルを取得します。
GetBundle(String, Locale, ClassLoader)	指定した基本名、ロケール、およびクラスローダーを使用してリソースバンドルを取得します。
GetBundle(String, Locale, ClassLoader, ResourceBundle+Control)	指定した基本名、既定のロケール、および呼び出し元のクラスローダーを使用して、リソースバンドルを取得します。
GetBundle(String, Locale, ResourceBundle+Control)	指定した基本名、既定のロケール、および呼び出し元のクラスローダーを使用して、リソースバンドルを取得します。
GetBundle(String, ResourceBundle+Control)	指定した基本名、既定のロケール、および呼び出し元のクラスローダーを使用して、リソースバンドルを取得します。
GetHashCode()	オブジェクトのハッシュコード値を返します。 (継承元 Object)
GetObject(String)	このリソースバンドルまたはその親の 1 つから、指定されたキーのオブジェクトを取得します。
GetString(String)	このリソースバンドルまたはその親の 1 つから、指定されたキーの文字列を取得します。
GetStringArray(String)	このリソースバンドルまたはその親の 1 つから、指定されたキーの文字列配列を取得します。
HandleGetObject(String)	このリソースバンドルから、指定されたキーのオブジェクトを取得します。
HandleKeySet()	`Set`この `ResourceBundle`に含まれる <em>のみ</em> キーのを返します。
JavaFinalize()	ガベージコレクションがオブジェクトへの参照がなくなったと判断したときに、オブジェクトのガベージコレクターによって呼び出されます。 (継承元 Object)
KeySet()	`Set`この`ResourceBundle`および親バンドルに含まれるすべてのキーのを返します。
Notify()	このオブジェクトのモニターで待機している 1 つのスレッドをウェイクアップします。 (継承元 Object)
NotifyAll()	このオブジェクトのモニターで待機しているすべてのスレッドをウェイクアップします。 (継承元 Object)
SetHandle(IntPtr, JniHandleOwnership)	Handle プロパティを設定します。 (継承元 Object)
SetParent(ResourceBundle)	このバンドルの親バンドルを設定します。
ToArray<T>()	リソースバンドルには、ロケール固有のオブジェクトが含まれています。 (継承元 Object)
ToString()	オブジェクトの文字列形式を返します。 (継承元 Object)
UnregisterFromRuntime()	リソースバンドルには、ロケール固有のオブジェクトが含まれています。 (継承元 Object)
Wait()	現在のスレッドが起動するまで待機します。通常<>は、通知</em> または <em>割り込み</em によって待機します>。 (継承元 Object)
Wait(Int64)	現在のスレッドが起動するまで待機します。通常<>は、通知</em> または>< em 割り込み</em>、または一定のリアルタイムが経過するまで待機します。 (継承元 Object)
Wait(Int64, Int32)	現在のスレッドが起動するまで待機します。通常<>は、通知</em> または>< em 割り込み</em>、または一定のリアルタイムが経過するまで待機します。 (継承元 Object)

明示的なインターフェイスの実装

IJavaPeerable.Disposed()	リソースバンドルには、ロケール固有のオブジェクトが含まれています。 (継承元 Object)
IJavaPeerable.DisposeUnlessReferenced()	リソースバンドルには、ロケール固有のオブジェクトが含まれています。 (継承元 Object)
IJavaPeerable.Finalized()	リソースバンドルには、ロケール固有のオブジェクトが含まれています。 (継承元 Object)
IJavaPeerable.JniManagedPeerState	リソースバンドルには、ロケール固有のオブジェクトが含まれています。 (継承元 Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	リソースバンドルには、ロケール固有のオブジェクトが含まれています。 (継承元 Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	リソースバンドルには、ロケール固有のオブジェクトが含まれています。 (継承元 Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	リソースバンドルには、ロケール固有のオブジェクトが含まれています。 (継承元 Object)

拡張メソッド

JavaCast<TResult>(IJavaObject)	Android ランタイムチェック型変換を実行します。
JavaCast<TResult>(IJavaObject)	リソースバンドルには、ロケール固有のオブジェクトが含まれています。
GetJniTypeName(IJavaPeerable)	リソースバンドルには、ロケール固有のオブジェクトが含まれています。

適用対象