この記事の英語版を表示するには、[英語] のチェック ボックスをオンにしてください。また、テキストにマウス ポインターを合わせると、ポップアップ ウィンドウに英語のテキストを表示することもできます。
翻訳
英語
このドキュメントはアーカイブされており、メンテナンスされていません。

ResourceManager.GetObject メソッド (String, CultureInfo)

指定されたカルチャ用にローカライズされている Object リソースの値を取得します。

名前空間:  System.Resources
アセンブリ:  mscorlib (mscorlib.dll 内)

public virtual Object GetObject(
	string name,
	CultureInfo culture
)

パラメーター

name
型: System.String
取得するリソースの名前。
culture
型: System.Globalization.CultureInfo
リソースのローカライズ先のカルチャを表す CultureInfo オブジェクト。 リソースがこのカルチャ用にローカライズされていない場合、カルチャの Parent プロパティを使用して代わりとなるカルチャが検索され、ニュートラル カルチャを調べた後で検索が終了します。
この値が null の場合は、カルチャの CurrentUICulture プロパティを使用して CultureInfo を取得します。

戻り値

型: System.Object
指定されたカルチャ用にローカライズされているリソースの値。 最適な値を取得できない場合は、null が返されます。

例外条件
ArgumentNullException

name パラメーターが null です。

MissingManifestResourceException

使用できるリソースのセットが見つからず、ニュートラル カルチャ リソースもありません。

リソースが指定したカルチャ用にローカライズされていない場合は、最も近いカルチャに合わせてローカライズされたリソースが返されます。この処理には、カルチャの Parent プロパティが使用されます。 それ以外の場合は、null が返されます。

使用できるリソースのセットが見つからない場合、ResourceManager はニュートラル カルチャのリソースを使用します。このリソースは、通常メイン アセンブリに格納されています。 適切なカルチャ リソースが見つからない場合は、MissingManifestResourceException がスローされます。

メモメモ

GetObject メソッドはスレッド セーフです。

Caution メモ注意

このメソッドでは、一覧にあるもの以外の例外もスローされることがあります。 この現象が発生する理由の 1 つは、このメソッドが呼び出すメソッドで例外がスローされるためです。 たとえば、サテライト アセンブリの配置またはインストールでエラーが発生した場合は FileLoadException がスローされる可能性があります。また、ユーザー定義の型を逆シリアル化するときに、その型でユーザー定義の例外がスローされた場合は SerializationException がスローされる可能性があります。

パフォーマンスに関する考慮事項

同じ name パラメーターで GetObject メソッドを複数回呼び出した場合、戻り値が同じオブジェクトの参照になるとは限りません。 これは、GetObject メソッドが、キャッシュ内の既存のリソース オブジェクトへの参照を返す場合と、リソースを再読み込みし、新しいリソース オブジェクトへの参照を返す場合とがあるためです。

.NET Framework

サポート対象: 4、3.5、3.0、2.0、1.1、1.0

.NET Framework Client Profile

サポート対象: 4、3.5 SP1

  • ReflectionPermission 

    (Type.InvokeMember などの機構を通じて遅延バインディングが呼び出されるときに必要なアクセス許可) ReflectionPermissionFlag.MemberAccess (関連する列挙体)

Windows 7, Windows Vista SP1 以降, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core はサポート対象外), Windows Server 2008 R2 (SP1 以降で Server Core をサポート), Windows Server 2003 SP2

.NET Framework では、各プラットフォームのすべてのバージョンはサポートしていません。 サポートされているバージョンについては、「.NET Framework システム要件」を参照してください。
表示: